Struct branchless::testing::Git

pub struct Git<'a> {
    pub repo_path: &'a Path,
    pub git_executable: &'a Path,
}

Wrapper around the Git executable, for testing.

Fields

repo_path: &'a Path

The path to the repository on disk. The directory itself must exist, although it might not have a .git folder in it. (Use Git::init_repo to initialize it.)

git_executable: &'a Path

The path to the Git executable on disk. This is important since we test against multiple Git versions.

Implementations

impl<'a> Git<'a>

pub fn new(repo_path: &'a Path, git_executable: &'a GitExecutable<'_>) -> Self

Constructor.

pub fn preprocess_stdout(&self, stdout: String) -> Result<String>

Replace dynamic strings in the output, for testing purposes.

pub fn get_path_for_env(&self) -> String

Get the PATH environment variable to use for testing.

pub fn run_with_options<S: AsRef<str> + Debug>(
    &self,
    args: &[S],
    options: &GitRunOptions
) -> Result<(String, String)>

Run a Git command.

pub fn run<S: AsRef<str> + Debug>(&self, args: &[S]) -> Result<(String, String)>

Run a Git command.

pub fn init_repo_with_options(&self, options: &GitInitOptions) -> Result<()>

Set up a Git repo in the directory and initialize git-branchless to work with it.

pub fn init_repo(&self) -> Result<()>

Set up a Git repo in the directory and initialize git-branchless to work with it.

pub fn commit_file_with_contents(
    &self,
    name: &str,
    time: isize,
    contents: &str
) -> Result<Oid>

Commit a file with default contents. The time argument is used to set the commit timestamp, which is factored into the commit hash.

pub fn commit_file(&self, name: &str, time: isize) -> Result<Oid>

Commit a file with default contents. The time argument is used to set the commit timestamp, which is factored into the commit hash.

pub fn detach_head(&self) -> Result<()>

Detach HEAD. This is useful to call to make sure that no branch is checked out, and therefore that future commit operations don’t move any branches.

pub fn get_repo(&self) -> Result<Repository>

Get a git2::Repository object for this repository.

pub fn get_version(&self) -> Result<GitVersion>

Get the version of the Git executable.

pub fn supports_reference_transactions(&self) -> Result<bool>

Determine if the Git executable supports the reference-transaction hook.

pub fn resolve_file(&self, name: &str, contents: &str) -> Result<()>

Resolve a file during a merge or rebase conflict with the provided contents.

Trait Implementations

impl<'a> Debug for Git<'a>

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

Formats the value using the given formatter.