radicle-surf 0.29.0

A code surfing library for Git repositories
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

use std::{convert::Infallible, path::Path};

use git2::{Oid, RepositoryInitOptions};
use radicle_git_metadata::commit::CommitData;
use radicle_git_ref_format::RefString;

use crate::test::r#gen::commit::{self, TreeData};
pub struct Fixture {
    #[allow(unused)] // Prevent early removal of the temporary directory.
    dir: tempfile::TempDir,

    pub inner: git2::Repository,
    pub head: Option<git2::Oid>,
}

/// Initialise a [`git2::Repository`] in a temporary directory.
///
/// The provided `commits` will be added to the repository, and the
/// head commit will be returned.
pub fn fixture(refname: &RefString, commits: Vec<CommitData<TreeData, Infallible>>) -> Fixture {
    let dir = tempfile::tempdir().unwrap();
    let repo = git2::Repository::init_opts(
        dir.path(),
        RepositoryInitOptions::new().initial_head(refname),
    )
    .unwrap();
    let commits = commit::write_commits(&repo, commits).unwrap();
    let head = commits.last().copied();

    if let Some(head) = head {
        repo.reference(refname.as_str(), head, false, "Initialise repository")
            .unwrap();
    }

    Fixture {
        dir,
        inner: repo,
        head,
    }
}

pub fn bare_fixture(
    refname: &RefString,
    commits: Vec<CommitData<TreeData, Infallible>>,
) -> Fixture {
    let dir = tempfile::tempdir().unwrap();
    let repo = git2::Repository::init_opts(
        dir.path(),
        RepositoryInitOptions::new()
            .initial_head(refname)
            .bare(true),
    )
    .unwrap();
    let commits = commit::write_commits(&repo, commits).unwrap();
    let head = commits.last().copied();

    if let Some(head) = head {
        repo.reference(refname.as_str(), head, false, "Initialise repository")
            .unwrap();
    }

    Fixture {
        dir,
        inner: repo,
        head,
    }
}

pub fn submodule<'a>(
    parent: &'a git2::Repository,
    child: &'a git2::Repository,
    refname: &RefString,
    head: Oid,
    author: &git2::Signature,
) -> git2::Submodule<'a> {
    let url = format!("file://{}", child.path().canonicalize().unwrap().display());
    let mut sub = parent
        .submodule(url.as_str(), Path::new("submodule"), true)
        .unwrap();
    let _ = sub.open().unwrap();
    let _ = sub
        .clone(Some(&mut git2::SubmoduleUpdateOptions::default()))
        .unwrap();
    sub.add_to_index(true).unwrap();
    sub.add_finalize().unwrap();
    {
        let mut ix = parent.index().unwrap();
        let tree = ix.write_tree_to(parent).unwrap();
        let tree = parent.find_tree(tree).unwrap();
        let head = parent.find_commit(head).unwrap();
        parent
            .commit(
                Some(refname.as_str()),
                author,
                author,
                "Commit submodule",
                &tree,
                &[&head],
            )
            .unwrap();
    }
    sub
}