Struct SnapshotGraph 

pub struct SnapshotGraph;

Read-only operations over a snapshot object graph.

Bashkit does not own the store, so every method takes the objects it needs. A method only walks as far as the supplied ObjectSource reaches.

Implementations

impl SnapshotGraph

pub fn read_commit( root: CommitId, source: &impl ObjectSource, ) -> Result<CommitObject>

Decode a commit object.

pub fn parents( root: CommitId, source: &impl ObjectSource, ) -> Result<Vec<CommitId>>

Commits root descends from.

pub fn meta( root: CommitId, source: &impl ObjectSource, ) -> Result<BTreeMap<String, String>>

Host metadata attached at commit time.

pub fn capabilities( root: CommitId, source: &impl ObjectSource, ) -> Result<CapabilityFingerprint>

Capability fingerprint of the instance that produced root.

pub fn ancestry( root: CommitId, source: &impl ObjectSource, limit: usize, ) -> Result<Vec<CommitId>>

Walk ancestry from root, newest first, stopping at limit commits or at the first ancestor the source does not contain.

Cycles are impossible in a well-formed graph (a commit’s ID covers its parents) but a hostile store can serve one anyway, so already-visited commits are skipped rather than trusted.

pub fn plan_checkout( root: CommitId, source: &impl ObjectSource, ) -> Result<Vec<ObjectId>>

Object IDs needed to check out root that source does not have.

Call repeatedly — fetching one wave reveals the next — until it returns an empty vector.

pub fn reachable( root: CommitId, source: &impl ObjectSource, ) -> Result<Vec<ObjectId>>

Every object root reaches, for a host implementing garbage collection.

Errors

Fails if any reachable object is missing from source; use plan_checkout when partial results are fine.

pub fn diff( a: CommitId, b: CommitId, source: &impl ObjectSource, ) -> Result<SnapshotDiff>

Compare two commits.