Struct FileTransitionLog 

pub struct FileTransitionLog<T: LinkReference> { /* private fields */ }

A versioned, checksummed append-only file journal.

Every append uses sync_all. Opening validates every complete record and removes a torn final line before further appends. Corrupt complete records and addresses too wide for the requested T are errors, never skipped. Creating a new file requires its parent directory to exist; synchronize that directory before relying on a newly created path surviving a system crash. File locking and retention are the caller’s responsibility.

Implementations

impl<T: LinkReference> FileTransitionLog<T>

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

Opens or creates a journal and validates/repairs its final append.

Trait Implementations

impl<T: Debug + LinkReference> Debug for FileTransitionLog<T>

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

Formats the value using the given formatter.

impl<T: LinkReference> TransitionLog<T> for FileTransitionLog<T>

fn read_entries(&mut self) -> Result<Vec<JournalEntry<T>>>

Reads all complete records in append order.

fn append(&mut self, entry: &JournalEntry<T>) -> Result<()>

Appends and, for durable implementations, synchronizes one record.