Struct FileNameStore 

pub struct FileNameStore { /* private fields */ }

The CLI’s registry: one JSON file per name in a directory, owner-only on Unix.

Implementations

impl FileNameStore

pub fn new(dir: impl Into<PathBuf>) -> FileNameStore

A store over the directory that holds the name files themselves.

pub fn in_state_root(state_root: &Path) -> FileNameStore

The registry under state_root/names — where the CLI keeps it.

A subdirectory rather than the state root because the run ledger’s *.json glob must never read a name record as a ledger.

pub fn default_location(env: &dyn Fn(&str) -> Option<String>) -> FileNameStore

The registry the CLI would use in this environment.

If no absolute home can be resolved, the returned store refuses every storage operation with a precondition error and its directory is empty.

pub fn dir(&self) -> &Path

The directory holding the name files.

pub fn path_of(&self, name: &str) -> PathBuf

Where name’s record lives, whether or not one is registered.

Trait Implementations

impl Clone for FileNameStore

fn clone(&self) -> FileNameStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileNameStore

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

Formats the value using the given formatter.

impl NameStore for FileNameStore

fn get(&self, name: &str) -> Result<Option<NameRecord>, Error>

A file that exists but does not parse is an error, not a free name: a torn record is what a killed write leaves, and treating it as free would let a second VM claim a name whose first holder may still be billing.

fn list(&self) -> Result<Vec<NameRecord>, Error>

Skips files that are not records: a torn file is reported by NameStore::get for its own name, and must not make every other name unlistable.

fn put(&self, record: &NameRecord) -> Result<(), Error>

Writes record under its name, replacing any earlier record.

fn delete(&self, name: &str) -> Result<bool, Error>

Removes name, answering whether a record was there.

fn describe(&self) -> String

Where this store keeps names, for error messages.

fn release_by_vm(&self, microvm_id: &str) -> Result<Vec<String>, Error>

Removes every name registered to microvm_id and returns them, sorted.