Struct GitRepo 

pub struct GitRepo { /* private fields */ }

Implementations

impl GitRepo

pub fn open(path: &Path) -> Result<Self>

Open a git repository. path may be the work-tree root (contains .git/) or the bare .git directory itself.

pub fn head(&self) -> Result<GitHash>

Resolve HEAD to its commit hash.

pub fn resolve_ref(&self, name: &str) -> Result<GitHash>

Resolve any ref name (e.g. "HEAD", "refs/heads/main", or a bare hex hash).

pub fn read_object(&self, hash: &GitHash) -> Result<RawObject>

Read and verify an object by hash, from a loose file or a packfile.

Loose objects are tried first; if absent, every packfile is searched (resolving OFS_DELTA/REF_DELTA chains). A truly missing object yields GitError::ObjectNotFound; an unsupported pack index version yields the distinct GitError::PackfileUnsupported — never a misleading not-found.

pub fn read_commit(&self, hash: &GitHash) -> Result<CommitObject>

Read and parse a commit object.

pub fn read_tree(&self, hash: &GitHash) -> Result<TreeObject>

Read and parse a tree object.

pub fn read_blob(&self, hash: &GitHash) -> Result<Vec<u8>>

Read a blob object and return its raw bytes.

pub fn walk_commits( &self, from: GitHash, ) -> impl Iterator<Item = Result<CommitObject>> + '_

Walk the commit ancestry chain, newest-first (first-parent only).

pub fn reflog(&self, refname: &str) -> Result<Vec<ReflogEntry>>

Read the reflog for refname (e.g. "HEAD", "refs/heads/main").

Returns an empty vec when the log file is absent (git creates one only after the ref first moves), never an error for mere absence.

Errors

Propagates a non-NotFound I/O error encountered reading the log file.

pub fn all_objects(&self) -> Result<Vec<GitHash>>

Every object in the store: the union of loose and packed objects, with duplicates removed (an object may be both loose and packed mid-gc).

Errors

Propagates a GitError from packfile-index enumeration.

pub fn all_refs(&self) -> Vec<(String, GitHash)>

Every ref in the repository as (refname, target_hash) pairs (loose refs/**, packed-refs, and HEAD).