Struct CasStore 

pub struct CasStore { /* private fields */ }

Content-addressable chunk store.

Implementations

impl CasStore

pub fn open(path: &Path) -> Result<Self>

Open or create a CAS store at {path}/.foxing_cas/.

pub fn store_file( &self, rel_path: &str, data: &[u8], meta: &FileMeta, ) -> Result<CasStoreStats>

Store a file by chunking its data and writing unique chunks.

pub fn delta_store_file( &self, rel_path: &str, data: &[u8], meta: &FileMeta, ) -> Result<DeltaStoreStats>

Store a file using chunk-level delta, writing only changed chunks.

pub fn delete_file(&self, rel_path: &str) -> Result<()>

Record a file deletion in the manifest.

pub fn rename_file(&self, from: &str, to: &str) -> Result<()>

Record a file rename in the manifest.

pub fn snapshot(&self, name: &str) -> Result<()>

Record a snapshot marker in the manifest.

pub fn read_file(&self, rel_path: &str) -> Result<Vec<u8>>

Reconstruct a file from its chunks.

pub fn list_files(&self) -> Result<Vec<FileEntry>>

Replay manifest to get current file state.

pub fn compact(&self) -> Result<CompactStats>

Compact the manifest and remove orphaned chunks.

pub fn stats(&self) -> Result<(u64, u64, u64)>

Get store statistics.

pub fn store_fxar_as_cas(&self, archive_name: &str, data: &[u8]) -> Result<()>

Store an FXAR archive as a CAS-chunked entity under a synthetic path.

pub fn read_fxar_from_cas(&self, archive_name: &str) -> Result<Vec<u8>>

Read an FXAR archive back from CAS, reconstructing it byte-identically.

pub fn has_fxar_in_cas(&self, archive_name: &str) -> Result<bool>

Check whether an FXAR archive exists in this CAS store.

pub fn import_fxar<R: Read + Seek>(&self, reader: R) -> Result<CasStoreStats>

Import an FXAR v2 archive into this CAS store. Reads the archive, stores unique chunks, and creates manifest entries.

pub fn export_fxar<W: Write + Seek>( &self, writer: W, compress: &str, ) -> Result<FxarExportStats>

Export this CAS store as an FXAR v2 archive.

pub fn store_files_batch( &self, files: &[(String, &[u8], &FileMeta)], ) -> Result<BatchStats>

Store multiple files in a single batch with amortized fsync.

Reduces NFS COMMIT RPCs from 2N (per-chunk sync + per-chunk dir sync) to ~3 for an N-file batch by deferring all fsyncs to two bulk phases: Phase 1: write all chunks (tmp -> rename, no fsync) Phase 2: fsync each unique chunk shard directory (typically 1-3) Phase 3: append all manifest entries + single fsync

Trait Implementations

impl Debug for CasStore

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

Formats the value using the given formatter.