Struct GitRepo 

pub struct GitRepo { /* private fields */ }

Implementations

impl GitRepo

pub fn open() -> WtgResult<Self>

Open the git repository from the current directory. Fetch is disabled by default for local repos.

pub fn from_path(path: &Path) -> WtgResult<Self>

Open the git repository from a specific path. Fetch is disabled by default.

pub fn remote(gh_repo_info: GhRepoInfo) -> WtgResult<Self>

Open or clone a remote GitHub repository. Uses a cache directory (~/.cache/wtg/repos). Fetch is enabled by default.

pub fn remote_with_notices( gh_repo_info: GhRepoInfo, notice_cb: NoticeCallback, ) -> WtgResult<Self>

Open or clone a remote GitHub repository with a notice callback. Uses a cache directory (~/.cache/wtg/repos). Fetch is enabled by default.

pub fn path(&self) -> &Path

Get the repository path

pub fn remote_url(&self) -> Option<&str>

Get the remote URL for fetching

pub const fn set_allow_fetch(&mut self, allow: bool)

Set whether fetching is allowed. Use this to enable --fetch flag for local repos.

pub fn set_notice_callback(&mut self, cb: NoticeCallback)

Set the notice callback for emitting operational messages.

pub const fn gh_repo_info(&self) -> Option<&GhRepoInfo>

Get a reference to the stored GitHub repo info (owner/repo) if explicitly set.

pub fn find_commit(&self, hash_str: &str) -> WtgResult<Option<CommitInfo>>

Find a commit by hash (can be short or full). If allow_fetch is true and the commit isn’t found locally, attempts to fetch it.

pub fn find_commit_local(&self, hash_str: &str) -> Option<CommitInfo>

Find a commit by hash locally only (no fetch).

pub fn has_path_at_head(&self, path: &str) -> bool

pub fn has_tag_named(&self, name: &str) -> bool

pub fn find_branch_path_match( &self, segments: &[String], ) -> Option<(String, Vec<String>)>

pub fn find_file_on_branch(&self, branch: &str, path: &str) -> Option<FileInfo>

Find a file in the repository

pub fn get_tags(&self) -> Vec<TagInfo>

Get all tags in the repository.

pub fn commits_between( &self, from_ref: &str, to_ref: &str, limit: usize, ) -> Vec<CommitInfo>

Get commits between two refs (from exclusive, to inclusive). Returns commits in reverse chronological order (most recent first).

pub fn tags_containing_commit(&self, commit_hash: &str) -> Vec<TagInfo>

Expose tags that contain the specified commit. If allow_fetch is true, ensures tags are fetched first.

pub fn tag_from_release(&self, release: &ReleaseInfo) -> Option<TagInfo>

Convert a GitHub release into tag metadata if the tag exists locally.

pub fn tag_contains_commit( &self, tag_commit_hash: &str, commit_hash: &str, ) -> bool

Check whether a release tag contains the specified commit.

pub fn remotes(&self) -> impl Iterator<Item = RemoteInfo>

Iterate over all remotes in the repository. Returns an iterator of RemoteInfo.

pub fn github_remote(&self) -> Option<GhRepoInfo>

Get the GitHub remote info. Returns stored gh_repo_info if set, otherwise extracts from git remotes using the remotes() API with priority ordering (upstream > origin > other, GitHub remotes first within each kind).