monochromatic-git-policy-cli 0.5.4

Repository-owned Git policy wrapper: forwards Git commands and checks commits against configured policies.
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

//! Controls for the in-process shadow skeleton:
//!  it is compared with what real `git init --bare --template=` creates, and real Git must accept it as a repository.

use super::*;
use crate::test_support::{fixture, git, git_text, remove};
use std::collections::BTreeSet;
use std::path::PathBuf;

/// Every entry under `root` as a path relative to it and whether it is a directory.
fn entries_under(root: &Path) -> BTreeSet<(String, bool)> {
    let mut found: BTreeSet<(String, bool)> = BTreeSet::new();
    let mut pending: Vec<PathBuf> = vec![root.to_path_buf()];
    while let Some(directory) = pending.pop() {
        for entry in std::fs::read_dir(&directory).expect("read directory") {
            let path: PathBuf = entry.expect("directory entry").path();
            let is_directory: bool = path.is_dir();
            let relative: String = path.strip_prefix(root).expect("under root").display().to_string();
            found.insert((relative, is_directory));
            if is_directory {
                pending.push(path);
            }
        }
    }
    return found;
}

/// The skeleton holds every entry real Git creates for an empty bare repository except `config`,
///  which the shadow writes itself, and nothing real Git does not create.
#[test]
fn skeleton_matches_the_entries_real_git_init_creates_except_config() {
    let root: PathBuf = fixture("shadow-skeleton-differential");
    let made: PathBuf = root.join("made");
    let reference: PathBuf = root.join("reference");
    create_shadow_skeleton_in_new_directory(made.as_path());
    git(
        root.as_path(),
        &["init", "--bare", "--quiet", "--template=", "--object-format=sha1", reference.to_str().expect("UTF-8 path")],
    );
    let ours: BTreeSet<(String, bool)> = entries_under(made.as_path());
    let mut theirs: BTreeSet<(String, bool)> = entries_under(reference.as_path());
    assert!(theirs.remove(&(String::from("config"), false)), "real Git writes a config file");
    assert_eq!(ours, theirs);
    remove(root.as_path());
}

/// Real Git reads the skeleton, given the config the shadow writes, as a bare repository whose `HEAD` is symbolic.
#[test]
fn real_git_accepts_the_skeleton_as_a_bare_repository() {
    let root: PathBuf = fixture("shadow-skeleton-accepted");
    let made: PathBuf = root.join("made");
    create_shadow_skeleton_in_new_directory(made.as_path());
    std::fs::write(made.join("config"), "[core]\n\trepositoryformatversion = 0\n\tbare = true\n").expect("config");
    let directory: String = format!("--git-dir={}", made.display());
    assert_eq!(git_text(root.as_path(), &[directory.as_str(), "rev-parse", "--is-bare-repository"]), "true");
    let head: String = git_text(root.as_path(), &[directory.as_str(), "symbolic-ref", "HEAD"]);
    assert!(head.starts_with("refs/heads/"), "HEAD names a branch: {head}");
    remove(root.as_path());
}

/// A directory another run already made is not an error, as with `git init`, and `HEAD` is written again.
#[test]
fn skeleton_over_an_existing_repository_directory_succeeds() {
    let root: PathBuf = fixture("shadow-skeleton-existing");
    let made: PathBuf = root.join("made");
    create_shadow_skeleton_in_new_directory(made.as_path());
    std::fs::write(made.join("HEAD"), "torn").expect("torn HEAD");
    create_shadow_skeleton(made.as_path()).expect("second creation");
    assert_eq!(std::fs::read_to_string(made.join("HEAD")).expect("HEAD"), PLACEHOLDER_HEAD);
    remove(root.as_path());
}

/// A shadow directory whose parent is missing is reported, never created implicitly.
#[test]
fn skeleton_without_a_parent_directory_fails() {
    let root: PathBuf = fixture("shadow-skeleton-orphan");
    let error: std::io::Error =
        create_shadow_skeleton(root.join("missing").join("shadow").as_path()).expect_err("no parent");
    assert_eq!(error.kind(), std::io::ErrorKind::NotFound);
    remove(root.as_path());
}

/// Creates the skeleton in a directory that does not exist yet, as the shadow creation does.
fn create_shadow_skeleton_in_new_directory(directory: &Path) {
    create_shadow_skeleton(directory).expect("skeleton");
}