Struct Repository 

pub struct Repository {
    pub git_dir: PathBuf,
    pub work_tree: Option<PathBuf>,
    pub odb: Odb,
}

A handle to an open Git repository.

Fields

git_dir: PathBuf

Absolute path to the git directory (.git/ or bare repo root).

work_tree: Option<PathBuf>

Absolute path to the working tree, or None for bare repos.

odb: Odb

Loose object database.

Implementations

impl Repository

pub fn open(git_dir: &Path, work_tree: Option<&Path>) -> Result<Self>

Open a repository from an explicit git-dir and optional work-tree.

Errors

Returns Error::NotARepository if git_dir does not look like a valid git directory (missing objects/, HEAD, etc.).

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

Discover the repository starting from start (defaults to cwd if None).

Checks GIT_DIR first; if set, uses it directly. Otherwise walks up the directory tree looking for .git (regular directory or gitfile).

Errors

Returns Error::NotARepository if no repository can be found.

pub fn index_path(&self) -> PathBuf

Path to the index file.

pub fn refs_dir(&self) -> PathBuf

Path to the refs/ directory.

pub fn head_path(&self) -> PathBuf

Path to HEAD.

pub fn is_bare(&self) -> bool

Whether this is a bare repository (no working tree).

Trait Implementations

impl Debug for Repository

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

Formats the value using the given formatter.