Struct RepositoryIdentity 

pub struct RepositoryIdentity { /* private fields */ }

The repository a command is operating on, and every work tree git has registered for it.

Built once per command and passed around. A handful of subprocesses go into it and no more: the identity questions, one worktree list, and the trunk lookups.

Implementations

impl RepositoryIdentity

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

Resolve the repository from any directory inside any of its work trees.

pub fn refresh(&mut self) -> Result<()>

Re-read the registered work trees. Under the lock, before a mutation, because the topology may have changed since discovery.

pub fn git_common_dir(&self) -> &ResolvedPath

The common git directory every work tree of this repository shares. It is the repository’s identity: two paths belong to one repository exactly when this matches.

pub fn primary_worktree(&self) -> &ResolvedPath

The primary checkout — the main work tree, never a linked one, whatever directory the command was run from.

pub fn current_worktree(&self) -> &ResolvedPath

The work tree the command was run inside.

pub fn trunk(&self) -> &Trunk

The trunk, as discovered.

pub fn repository_name(&self) -> String

The primary checkout’s directory name: what the container is named after.

pub fn registered_worktrees(&self) -> &[WorktreeRecord]

Every work tree git has registered, primary first, exactly as the porcelain listed them.

pub fn is_primary(&self, record: &WorktreeRecord) -> bool

Is this record the primary checkout?

pub fn is_current(&self, record: &WorktreeRecord) -> bool

Is the command running inside this record’s work tree?

pub fn current_record(&self) -> Option<&WorktreeRecord>

The record of the work tree the command runs in, when git lists it.

pub fn record_of_branch(&self, branch: &str) -> Option<&WorktreeRecord>

The record holding a branch, when one does.

pub fn record_at(&self, path: &ResolvedPath) -> Option<&WorktreeRecord>

The record registered at a path, whatever the path is called.

Trait Implementations

impl Clone for RepositoryIdentity

fn clone(&self) -> RepositoryIdentity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RepositoryIdentity

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

Formats the value using the given formatter.