Struct git_workarea::GitContext

pub struct GitContext { /* fields omitted */ }

A context for performing git commands.

Methods

impl GitContext

fn new<P>(gitdir: P) -> Self where
    P: AsRef<Path>, 

Create a new context for the given directory.

fn new_with_config<P, C>(gitdir: P, config: C) -> Self where
    P: AsRef<Path>,
    C: AsRef<Path>, 

Create a new context for the given directory with git configuration.

fn git(&self) -> Command

Run a git command in the context.

This builds a Command with the proper environment to operate within the context.

fn fetch<R, I, N>(&self, remote: R, refnames: I) -> Result<()> where
    R: AsRef<str>,
    I: IntoIterator<Item = N>,
    N: AsRef<OsStr>, 

Fetch references from the given remote.

The remote is interpreted by Git, so it can be a remote or a specific URL.

fn fetch_into<R, N, T>(&self, remote: R, refname: N, target: T) -> Result<()> where
    R: AsRef<str>,
    N: AsRef<str>,
    T: AsRef<str>, 

Fetch a commit from the given remote into a specific local refname.

fn force_fetch_into<R, N, T>(
    &self,
    remote: R,
    refname: N,
    target: T
) -> Result<()> where
    R: AsRef<str>,
    N: AsRef<str>,
    T: AsRef<str>, 

Fetch a commit from the given remote into a specific local refname, allowing rewinds.

fn prepare(&self, rev: &CommitId) -> Result<GitWorkArea>

Create a tree where further work on the given revision can occur.

fn reserve_ref<N>(&self, name: N, commit: &CommitId) -> Result<(String, usize)> where
    N: AsRef<str>, 

Reserve a refname for the given commit.

Returns the name of the reserved ref pointing to the given commit and its ID.

The reserved reference is created as refs/{name}/heads/{id} where id is a unique integer (which is also returned).

fn reserve_refs<N>(
    &self,
    name: N,
    commit: &CommitId
) -> Result<(String, String)> where
    N: AsRef<str>, 

Reserve two refnames for the given commit.

Returns the names of the two reserved refs, the first pointing to the given commit and the second available for further work.

The reserved references are created as refs/{name}/heads/{id} and refs/{name}/bases/{id} where the bases reference is available to point to an object associated with the heads reference.

It is assumed that the bases refs are aligned with the heads references and not used for other purposes.

fn mergeable(&self, base: &CommitId, topic: &CommitId) -> Result<MergeStatus>

Check if a topic commit is mergeable into a target branch.

fn gitdir(&self) -> &Path

The path to the git repository.

Trait Implementations

impl Debug for GitContext

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Clone for GitContext

fn clone(&self) -> GitContext

Returns a copy of the value.

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

Performs copy-assignment from source.