Struct LatestSnapshot 

pub struct LatestSnapshot { /* private fields */ }

A reader pinned to one immutable latest generation.

Opening resolves the atomic pointer once and verifies the generation manifest and every listed artifact. Subsequent reads never re-resolve current, so a concurrent writer cannot mix generations for this reader.

Implementations

impl LatestSnapshot

pub fn open(root: impl AsRef<Path>) -> Result<Self, ArtifactPathError>

Resolve and verify the committed generation without writing or locking.

pub fn recover_stable_aliases( root: impl AsRef<Path>, ) -> Result<Self, ArtifactPathError>

Repair legacy root-level aliases from the committed generation.

This is idempotent and is also run automatically before every writer creates a new generation. The returned reader remains pinned to the generation used for recovery.

pub fn generation(&self) -> &str

Return the pinned generation identity.

pub fn path(&self) -> &Path

Return the immutable generation directory.

pub fn root(&self) -> &ApprovedRoot

Return the approved artifact root containing this snapshot.

pub fn manifest(&self) -> &LatestManifest

Return the verified versioned manifest.

pub fn open_artifact(&self, id: &ArtifactId) -> Result<File, ArtifactPathError>

Open one alias listed by this pinned generation.

Callers that need integrity verification should prefer LatestSnapshot::read_artifact, which verifies the exact bytes read against the pinned manifest.

pub fn read_artifact( &self, id: &ArtifactId, ) -> Result<Vec<u8>, ArtifactPathError>

Read one alias from this pinned generation.

Trait Implementations

impl Clone for LatestSnapshot

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LatestSnapshot

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

Formats the value using the given formatter.