Struct FsIndexStore 

pub struct FsIndexStore { /* private fields */ }

The reference index substrate: one file per node under <root>/index.

Layout: <root>/index/<aa>/<bb>/<64-hex> where aa/bb are the first two bytes of the id in hex. Writes are atomic (tmp -> fsync -> rename); reads are hash-verified by FsIndexStore::get.

Implementations

impl FsIndexStore

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

Open (creating if needed) an index store rooted at root, using root/index, with a fresh, private I/O counter set.

pub fn open_with_io(root: impl AsRef<Path>, io: IoCounters) -> Result<Self>

Open an index store that accounts every node read against io.

pub fn put(&mut self, canonical: &[u8]) -> Result<NodeId>

Store one canonical node, returning its content id. Idempotent and atomic.

pub fn get(&self, id: &NodeId) -> Result<Vec<u8>>

Fetch a node, verifying NodeId::of_node(bytes) == id.

pub fn contains(&self, id: &NodeId) -> Result<bool>

Whether a node id is present.

pub fn list_ids(&self) -> Result<Vec<NodeId>>

Every node id physically present in the index namespace.

Used to tell a genuinely new node from one a previous build already wrote (the index is content-addressed, so an unchanged node has an unchanged id and is never rewritten).

pub fn count(&self) -> Result<u64>

Number of stored nodes.

Trait Implementations

impl Debug for FsIndexStore

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

Formats the value using the given formatter.