Struct HistoryFile 

pub struct HistoryFile { /* private fields */ }

A workspace’s history file on this machine.

Plain text, one VaultPath per line. Non-critical by design: a missing, unreadable or half-written file costs the user an ordering, not a note, so reads never fail — they return what they could parse.

Implementations

impl HistoryFile

pub fn in_dir(dir: &SystemPath, workspace_name: &str) -> Self

The history for workspace_name inside dir.

The naming rule lives here, so a workspace resolves to the same file from every caller — the same reason IndexFile::in_dir exists. workspace_name must already be a valid filename.

pub fn path(&self) -> &SystemPath

The file’s path, for callers that need to report it.

pub fn exists(&self) -> bool

Whether the file exists. A workspace that has never been opened has no history, which is not an error.

pub fn load(&self) -> Vec<VaultPath>

The stored paths, newest first. Missing file, unreadable file or malformed lines all yield what could be read; failures are logged.

pub fn push(&self, path: &VaultPath) -> Result<(), SystemError>

Moves path to the front, dropping any earlier occurrence and truncating to LAST_PATH_HISTORY_SIZE. A no-op when it is already at the front — the common case of reopening the note you are editing.

pub fn write(&self, paths: &[VaultPath]) -> Result<(), SystemError>

Replaces the file’s contents with paths.

Atomic, because this rewrites the whole file on every note the user opens: a crash mid-write would otherwise leave a truncated history. The tmp-then-rename recipe itself lives in system — it is the same one every host-scoped writer needs, and getting it wrong is silent.

pub fn move_to(&self, dest: &HistoryFile) -> Result<(), SystemError>

Moves this history file to dest, for a workspace being renamed.

Refuses rather than overwrites: an existing destination aborts before anything moves. A source that does not exist is a no-op — a workspace with no history still renames.

pub fn remove(&self) -> Result<(), SystemError>

Deletes this history file. A missing file is not an error.

Trait Implementations

impl Clone for HistoryFile

fn clone(&self) -> HistoryFile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HistoryFile

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

Formats the value using the given formatter.

impl Display for HistoryFile

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

Formats the value using the given formatter.

impl Eq for HistoryFile

impl PartialEq for HistoryFile

fn eq(&self, other: &HistoryFile) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for HistoryFile