Struct VersionStore 

pub struct VersionStore { /* private fields */ }

Manages point-in-time snapshots with browsable tree directories and JSON manifest.

Implementations

impl VersionStore

pub fn open(target_root: &Path) -> Self

Open or create a version store at {target}/.foxing_versions/.

pub fn create_snapshot( &self, source: &Path, target: &Path, tag: Option<&str>, trigger: &str, ) -> Result<SnapshotEntry>

Create a point-in-time snapshot by reflinking all files from source->target into a timestamped tree directory.

pub fn list_snapshots(&self) -> Vec<SnapshotEntry>

List all snapshots (point-in-time directories).

pub fn delete_snapshot(&self, timestamp: &str) -> Result<u64>

Delete a snapshot by timestamp.

pub fn tag_snapshot(&self, timestamp: &str, tag: &str) -> Result<()>

Assigns a tag to a snapshot, exempting it from automatic pruning.

pub fn read_index(&self) -> Result<SnapshotIndex>

Reads and deserializes the JSON snapshot index from disk.

pub fn write_index(&self, index: &SnapshotIndex) -> Result<()>

Writes the snapshot index to disk as pretty-printed JSON.

pub fn rebuild_index(&self) -> Result<SnapshotIndex>

Rebuilds the snapshot index by scanning on-disk snapshot directories.

pub fn prune_by_age(&self, max_age: Duration) -> Result<PruneStats>

Remove snapshots older than max_age.

pub fn prune_by_count(&self, max_count: usize) -> Result<PruneStats>

Keep only the last max_count snapshots (oldest removed first).

pub fn prune_by_size(&self, max_bytes: u64) -> Result<PruneStats>

Remove oldest snapshots until total size is under max_bytes.

pub fn collect_snap_dirs( &self, timestamp_filter: Option<&str>, ) -> Result<Vec<PathBuf>>

Collect snapshot directories for export. Returns paths to snapshot dirs.

pub fn root(&self) -> &Path

Get the version store root path.

pub fn export<W: Write + 'static>( &self, writer: W, compress: &str, timestamp_filter: Option<&str>, ) -> Result<ArchiveExportStats>

Export snapshots as a .fxar archive (content-addressable chunk-dedup). Writes to the provided writer (file or stdout).

pub fn import<R: Read + 'static>( &self, reader: R, compress: &str, ) -> Result<ImportStats>

Import snapshots from a .fxar archive.

pub fn inspect_archive<R: Read + 'static>( reader: R, compress: &str, ) -> Result<Vec<ArchiveEntry>>

List contents of a .fxar archive without extracting.