Struct WorkspaceLayout 

pub struct WorkspaceLayout { /* private fields */ }

Where a workspace keeps its files.

Pure path arithmetic and one directory listing — it opens nothing and locks nothing. A caller that only needs “which file is work?” (the CLI resolving --db work) wants this and not the handle pool.

Implementations

impl WorkspaceLayout

pub fn new(root: impl Into<PathBuf>) -> Self

A layout rooted at root. Creates nothing; the directories appear when a database is first written.

pub fn root(&self) -> &Path

The workspace root.

pub fn db_dir(&self) -> PathBuf

The directory holding the databases, <root>/db.

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

The file backing name, <root>/db/<name>.plugmem.

A join of validated components, so the result is always inside WorkspaceLayout::db_dir.

pub fn registry_path(&self) -> PathBuf

The registry’s file, <root>/registry.plugmem. It sits in the root rather than beside the databases, so no name can collide with it.

pub fn exists(&self, name: &DbName) -> bool

Whether name is a database on disk.

Asks the storage layer rather than stat-ing the path: a database that has been written to but not yet checkpointed has no file at its base path, and treating it as absent would mean creating over it.

pub fn list(&self) -> Result<Vec<DbName>, WorkspaceError>

Every database in the workspace, sorted by name.

Reads the directory — the filesystem is the truth, the registry is only an index over it. A missing db/ is an empty workspace, not an error. Files whose name is not a database’s are skipped here and reported by the registry’s verify, which is where a person is asking about consistency rather than about what they can open.

One database is several files (chat-42.plugmem, .journal, .lock, .snap.N), so the listing folds them back to one name each: a name cannot contain a dot, so everything up to the first dot is the candidate, and the storage layer confirms whether a database is really there.

Errors

WorkspaceError::Io if the directory exists but cannot be read.

Trait Implementations

impl Clone for WorkspaceLayout

fn clone(&self) -> WorkspaceLayout

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkspaceLayout

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

Formats the value using the given formatter.

impl Eq for WorkspaceLayout

impl PartialEq for WorkspaceLayout

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WorkspaceLayout