Struct Workspace 

pub struct Workspace { /* private fields */ }

An open workspace: its root, .omgbase/ directory, database path and store.

Implementations

impl Workspace

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

Open the workspace rooted exactly at root, creating .omgbase/ and the database as needed.

pub fn open_with_minter( root: impl AsRef<Path>, minter: Box<dyn IdMinter>, ) -> Result<Self>

Workspace::open with a replaceable id minter (spec/store §2.2).

pub fn find(start: &Path) -> Result<Option<Self>>

The workspace containing start (walk up), or None.

pub fn locate(explicit: Option<&Path>, start: &Path) -> Result<Option<Self>>

§1 precedence: an explicit --workspace value, else $OMGBASE_WORKSPACE, else discovery from start.

pub fn root(&self) -> &Path

pub fn omgbase_dir(&self) -> &Path

<root>/.omgbase — where the locks live (§7).

pub fn db_path(&self) -> &Path

pub fn store(&self) -> &Store

pub fn store_mut(&mut self) -> &mut Store

pub fn repos(&self) -> Result<Vec<RepoRow>>

The repos with their derived roots, by slug.

pub fn repo_by_slug(&self, slug: &str) -> Result<Option<RepoRow>>

pub fn select_repo(&self, cwd: &Path, slug: Option<&str>) -> Result<RepoRow>

select_repo over this workspace’s repos.

pub fn has_repo(&self, slug: &str) -> Result<bool>

Whether slug exists (a cheap probe the registry uses).

pub fn close(self) -> Result<()>

Close the store.

Trait Implementations

impl Debug for Workspace

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

Formats the value using the given formatter.