Struct RepoScopes 

pub struct RepoScopes { /* private fields */ }

Buffer name → the repository that buffer acts on.

The DocumentId index is not redundant with the name map: Event::DocumentClosed carries a DocumentId, and the two are not interchangeable — the same reason ProjectDiffService keeps its own by_document.

Implementations

impl RepoScopes

pub fn set_resolver(&self, resolver: ProjectResolverHandle)

PR.5: hand the resolver over at boot.

Separate from construction because RepoScopes is built in magit’s install, and the resolver is a service looked up from the same boot — a constructor argument would just move the Option to the call site.

pub fn discovery_start(&self) -> Option<PathBuf>

PR.5: where step 3 starts discovering from.

The bug this fixes: magit’s fallback was Repository::discover(".") — the process’s working directory. :cd sets editor.current_dir and never calls set_current_dir, so after :cd /other/repo a fresh C-x g still opened the repository the editor was launched in.

Returns a directory to discover from, not an answer: magit needs a git worktree specifically, and the project root may not be one. gix walking up from here preserves “None when not in a repository” exactly as before.

pub fn record(&self, name: impl Into<String>, workdir: PathBuf)

Record (or re-point) the repository name acts on.

Overwrites rather than accumulating: re-triggering C-x g for a repository must find the buffer you already have, not stack a second record behind it.

pub fn workdir_for(&self, name: &str) -> Option<PathBuf>

The repository name acts on, if one was recorded.

None is a real answer, not a bug: a magit buffer reopened by :b after a restart has a name but no record, and the view falls back to resolving from scratch.

pub fn workdir_for_label(&self, label: &str) -> Option<PathBuf>

MR.3b: the repository behind a label, recovered from any magit buffer already recorded against it.

This is what lets a view opened from inside another magit buffer — <CR> on a commit in the log, a file at a revision — name itself correctly without reaching for services it does not have. Those producers sit in helpers holding only their own buffer’s state, so all they can carry across is the label their own name already spells; this turns that label back into a path.

Sound because labels are unique among open magit buffers by construction: two checkouts sharing a basename qualify at the trigger (RepoScopes::collides) precisely so that one label never names two repositories at once.

pub fn collides(&self, name: &str, workdir: &Path) -> bool

Is name already recorded against a different repository?

The collision question, asked by the trigger before it settles on a name. Merging two repositories into one buffer is the worst outcome available here — the staging chords would act on whichever was recorded last (design §3.1).

pub fn index_document(&self, document: DocumentId, name: impl Into<String>)

Index the document behind name, so closing the buffer drops the record. Called by the view when it activates — the first moment the document exists.

pub fn forget_by_document_id(&self, document: DocumentId) -> bool

Cleanup entry point for the DocumentClosed subscriber.

Returns whether anything was dropped, which is what makes the wiring testable without reaching into the maps.

pub fn tracked(&self) -> usize

How many buffers have a recorded repository. For tests and Debug; the accumulation failure mode is only visible as a count.

Trait Implementations

impl BufferScopeSource for RepoScopes

PR.6: RepoScopes already answers “which repository is the buffer called this acting on” — which is exactly what the editor’s generic project resolution needs from a buffer that has no path.

Implementing the trait rather than having the host read RepoScopesHandle keeps a magit-specific service out of generic host code: the host learns a directory and never learns whose, or that git was involved.

It works for every magit view at once — status, diff, log, stash, blame — because they all record through the same map.

fn scope_dir_for_name(&self, buffer_name: &str) -> Option<PathBuf>

The directory a buffer named buffer_name is about, if this source knows. None for a name it does not recognise — every source is asked and most will not know.

impl Debug for RepoScopes

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

Formats the value using the given formatter.

impl Default for RepoScopes

fn default() -> RepoScopes

Returns the “default value” for a type.