diffler-core 0.10.1

Core review engine for diffler: diffs, sessions, comments, viewed marks
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//! Git2 repo scaffolding shared by fixture builders in this crate's and
//! diffler's tests. Feature-gated so it never ships in a normal build.

// fixture helpers run outside #[test] fns, where clippy's test allowances don't reach
#![allow(clippy::expect_used)]

use std::path::Path;

pub fn init_repo(root: &Path, initial_branch: Option<&str>) -> git2::Repository {
    let repo = match initial_branch {
        Some(branch) => {
            let mut options = git2::RepositoryInitOptions::new();
            options.initial_head(branch);
            git2::Repository::init_opts(root, &options).expect("init")
        }
        None => git2::Repository::init(root).expect("init"),
    };
    let mut config = repo.config().expect("config");
    config.set_str("user.name", "test").expect("config");
    config.set_str("user.email", "test@test").expect("config");
    // pin line endings so checkout restores exact bytes across platforms
    config.set_str("core.autocrlf", "false").expect("config");
    config.set_str("core.eol", "lf").expect("config");
    repo
}

/// Give `branch` an upstream at revision `at`. The remote-tracking ref is
/// written locally, which is all git needs to count divergence.
pub fn track(repo: &git2::Repository, branch: &str, at: &str) {
    // set_upstream resolves the ref back to a remote, so one has to exist
    if repo.find_remote("origin").is_err() {
        repo.remote("origin", "https://example.invalid/repo.git")
            .expect("remote");
    }
    let oid = repo.revparse_single(at).expect("rev").id();
    repo.reference(&format!("refs/remotes/origin/{branch}"), oid, true, "track")
        .expect("remote ref");
    repo.find_branch(branch, git2::BranchType::Local)
        .expect("branch")
        .set_upstream(Some(&format!("origin/{branch}")))
        .expect("upstream");
}

pub fn commit_all(repo: &git2::Repository, message: &str, sig: &git2::Signature<'_>) {
    let mut index = repo.index().expect("index");
    index
        .add_all(["*"].iter(), git2::IndexAddOption::DEFAULT, None)
        .expect("add");
    index.write().expect("index write");
    let tree_id = index.write_tree().expect("tree");
    let tree = repo.find_tree(tree_id).expect("find tree");
    let parent = repo.head().ok().and_then(|h| h.peel_to_commit().ok());
    let parents: Vec<&git2::Commit<'_>> = parent.iter().collect();
    repo.commit(Some("HEAD"), sig, sig, message, &tree, &parents)
        .expect("commit");
}