Struct Repo 

pub struct Repo { /* private fields */ }

Repository facade that combines embedded and CLI capabilities.

Trait Implementations

impl Blamer for Repo

fn blame( &self, revision: &str, path: &str, opts: Option<&BlameOptions>, ) -> AppResult<Vec<BlameLine>>

Returns per-line blame information for a file at the given revision.

impl CheckoutManager for Repo

fn checkout( &self, ref_name: &str, opts: Option<&CheckoutOptions>, ) -> AppResult<()>

Checks out the given ref.

fn checkout_files(&self, paths: &[&str]) -> AppResult<()>

Checks out the provided paths from the index or HEAD.

impl CherryPicker for Repo

fn cherry_pick( &self, commit: &str, opts: Option<&CherryPickOptions>, ) -> AppResult<Oid>

Cherry-picks the given commit.

fn cherry_pick_continue(&self) -> AppResult<Oid>

Continues an in-progress cherry-pick.

fn cherry_pick_abort(&self) -> AppResult<()>

Aborts an in-progress cherry-pick.

impl Committer for Repo

fn commit(&self, message: &str, opts: Option<&CommitOptions>) -> AppResult<Oid>

Creates a commit from the current index state and returns its object ID.

impl ConfigReader for Repo

fn config_get(&self, key: &str) -> AppResult<String>

Returns the highest-precedence value for a config key.

fn config_get_all(&self, key: &str) -> AppResult<Vec<String>>

Returns all configured values for a multivar config key.

fn config_set(&self, key: &str, value: &str) -> AppResult<()>

Sets a config key in the repository configuration.

impl Differ for Repo

fn diff(&self, from: &str, to: &str) -> AppResult<Vec<DiffEntry>>

Returns file changes between two refs.

fn diff_stats(&self, from: &str, to: &str) -> AppResult<DiffStats>

Returns aggregated statistics for changes between two refs.

fn status(&self) -> AppResult<Vec<StatusEntry>>

Returns the working tree status.

impl Executor for Repo

fn exec(&self, args: &[&str]) -> AppResult<Vec<u8>>

Executes the git CLI with the provided arguments.

impl IgnoreReader for Repo

fn is_ignored(&self, path: &str) -> AppResult<bool>

Reports whether a repository-relative path is ignored by Git.

impl IndexManager for Repo

fn stage(&self, paths: &[&str]) -> AppResult<()>

Stages the provided repository-relative paths.

fn unstage(&self, paths: &[&str]) -> AppResult<()>

Removes the provided repository-relative paths from the index.

fn staged_entries(&self) -> AppResult<Vec<StatusEntry>>

Lists entries that currently differ between HEAD and the index.

impl IndexReader for Repo

fn index_entry(&self, path: &str) -> AppResult<Option<IndexEntry>>

Returns the index entry for path, if the path is present in the index.

impl Inspector for Repo

fn describe(&self, opts: Option<&DescribeOptions>) -> AppResult<String>

Describes the current revision in a human-readable form.

fn rev_parse(&self, revision: &str) -> AppResult<Oid>

Resolves a revision expression to an object ID.

fn grep( &self, pattern: &str, revision: &str, opts: Option<&GrepOptions>, ) -> AppResult<Vec<GrepMatch>>

Searches tracked content for pattern matches.

fn show(&self, object: &str) -> AppResult<Vec<u8>>

Returns raw object content for a revision expression.

impl LogReader for Repo

fn log(&self, opts: Option<&LogOptions>) -> AppResult<Vec<Commit>>

Returns commits reachable from HEAD, filtered by the provided options.

fn merge_base(&self, a: &str, b: &str) -> AppResult<Oid>

Returns the merge base between two revisions.

fn is_ancestor(&self, ancestor: &str, descendant: &str) -> AppResult<bool>

Reports whether ancestor is an ancestor of descendant.

impl Maintainer for Repo

fn gc(&self) -> AppResult<()>

Runs repository garbage collection.

fn prune(&self) -> AppResult<()>

Prunes unreachable objects.

fn fsck(&self) -> AppResult<()>

Verifies repository object integrity.

fn clean(&self, opts: Option<&CleanOptions>) -> AppResult<Vec<String>>

Cleans untracked files according to the provided options.

impl Merger for Repo

fn merge( &self, branch: &str, opts: Option<&MergeOptions>, ) -> AppResult<MergeResult>

Merges a branch into the current HEAD.

fn abort_merge(&self) -> AppResult<()>

Aborts an in-progress merge.

fn merge_abort(&self) -> AppResult<()>

Aborts an in-progress merge.

impl Rebaser for Repo

fn rebase( &self, onto: &str, opts: Option<&RebaseOptions>, ) -> AppResult<RebaseResult>

Rebases the current branch onto another target.

fn abort_rebase(&self) -> AppResult<()>

Aborts an in-progress rebase.

fn continue_rebase(&self) -> AppResult<RebaseResult>

Continues an in-progress rebase.

fn rebase_abort(&self) -> AppResult<()>

Aborts an in-progress rebase.

fn rebase_continue(&self) -> AppResult<RebaseResult>

Continues an in-progress rebase.

impl RefManager for Repo

fn list_branches(&self, filter: BranchFilter) -> AppResult<Vec<Branch>>

Lists branches matching the requested filter.

fn list_tags(&self) -> AppResult<Vec<Tag>>

Lists tags in the repository.

fn create_branch(&self, name: &str, target: &str) -> AppResult<()>

Creates a local branch pointing at the given target revision.

fn delete_branch(&self, name: &str) -> AppResult<()>

Deletes a local branch.

fn create_tag( &self, name: &str, target: &str, message: Option<&str>, ) -> AppResult<()>

Creates a tag pointing at the given target revision. Some(message) creates an annotated tag (with tagger and the given message, which may be empty); None creates a lightweight tag (a plain ref). Both backends must follow this convention.

fn delete_tag(&self, name: &str) -> AppResult<()>

Deletes a tag.

impl RemoteManager for Repo

fn list_remotes(&self) -> AppResult<Vec<Remote>>

Lists configured remotes.

fn fetch(&self, remote: &str, opts: Option<&FetchOptions>) -> AppResult<()>

Fetches updates from a remote.

fn push(&self, remote: &str, opts: Option<&PushOptions>) -> AppResult<()>

Pushes refs to a remote.

fn tracking_branch(&self, branch: &str) -> AppResult<String>

Returns the configured upstream tracking branch for a local branch.

impl Repository for Repo

fn root(&self) -> &Path

Returns the absolute path to the repository root.

fn head(&self) -> AppResult<Reference>

Returns the reference that HEAD points to.

fn resolve_ref(&self, refname: &str) -> AppResult<Oid>

Resolves a ref name (branch, tag, or SHA prefix) to an OID.

fn is_dirty(&self) -> AppResult<bool>

Reports whether the working tree has uncommitted changes.

impl Resetter for Repo

fn reset(&self, target: &str, mode: ResetMode) -> AppResult<()>

Resets repository state to the target revision.

impl Stasher for Repo

fn stash(&self, message: &str) -> AppResult<Oid>

Creates a stash entry.

fn stash_pop(&self) -> AppResult<()>

Applies and drops the top stash entry.

fn stash_pop_index(&self, index: usize) -> AppResult<()>

Applies and drops the selected stash entry.

fn stash_list(&self) -> AppResult<Vec<StashEntry>>

Lists stash entries.

fn stash_push(&self, message: &str) -> AppResult<Oid>

Creates a stash entry.

impl TreeReader for Repo

fn tree_hash(&self, revision: &str, path: &str) -> AppResult<TreeHash>

Returns the OID of the tree at the given path and revision.

fn file_at(&self, revision: &str, path: &str) -> AppResult<Vec<u8>>

Returns the content of a file at the given revision and path.

fn list_entries(&self, revision: &str, path: &str) -> AppResult<Vec<TreeEntry>>

Returns the entries in a tree at the given revision and path.