Struct Config 

pub struct Config {
    pub projects: BTreeMap<String, Project>,
}

Fields

projects: BTreeMap<String, Project>

Implementations

impl Config

pub fn load() -> Result<Self, Error>

pub fn save(&self) -> Result<(), Error>

Write the registry to disk atomically.

Callers that read-modify-write the registry should go through Config::update instead, so the whole cycle is serialized against other grove processes.

pub fn update<T, F>(f: F) -> Result<T, Error>

where F: FnOnce(&mut Self) -> Result<T, Error>,

Read-modify-write the registry while holding the exclusive config lock.

f receives the config as it exists on disk right now — not a copy loaded earlier — so concurrent grove processes queue up instead of dropping each other’s projects.

pub fn add_project(&mut self, name: String, path: PathBuf) -> Result<(), Error>

pub fn register_discovered(&mut self, name: &str, project: Project) -> bool

Register a discovered project to the registry, printing a message to stderr. Returns true if the project was newly registered, false if it was already present or could not be saved.

Only ever called for write-intent commands (see AutoRegister) — read-only commands must not mutate the registry, because grove env export runs on every directory change under the mise integration.

The registry is re-read under the config lock before the insert, so a project registered concurrently by another grove process is never dropped. On failure this prints a warning and leaves both disk and memory untouched; registration is a convenience and must never block the command that triggered it.

Unlike [add_project], this skips VCS validation and path canonicalization because discover() has already verified and canonicalized the path.

fn insert_discovered( name: &str, project: Project, ) -> Result<(Self, bool), Error>

Insert project into the on-disk registry under the config lock. Returns the resulting config and whether this call added the entry.

pub fn remove_project(&mut self, name: &str) -> Result<(), Error>

pub fn find_project_for_path( &self, path: &Path, ) -> Result<Option<ProjectRef>, Error>

Find which project a path belongs to.

Checks in order:

1. Path is a subdirectory of a project’s worktree base (more specific match)
2. Path is a subdirectory of a project’s main repo

Trait Implementations

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Config

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.