git-meta-cli 0.1.2

Command-line tool for structured Git metadata (get/set, serialize, materialize, push/pull). Installs the `git-meta` binary.
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

use predicates::prelude::*;
use tempfile::TempDir;

use crate::harness::{self, open_repo, ref_to_commit_oid, setup_repo};

#[test]
fn setup_reads_dot_git_meta_and_initializes_remote() {
    let (dir, _sha) = setup_repo();
    let bare_dir = TempDir::new().unwrap();
    let _ = gix::init_bare(bare_dir.path()).unwrap();
    let bare_path = bare_dir.path().to_str().unwrap();

    std::fs::write(dir.path().join(".git-meta"), format!("{bare_path}\n")).unwrap();

    harness::git_meta(dir.path())
        .args(["setup"])
        .assert()
        .success()
        .stderr(predicate::str::contains("Using metadata remote URL from"))
        .stderr(predicate::str::contains(".git-meta"))
        .stdout(predicate::str::contains("Added meta remote"));

    let local = open_repo(dir.path());
    let local_tip = ref_to_commit_oid(&local, "refs/meta/local/main");
    let tracking_tip = ref_to_commit_oid(&local, "refs/meta/remotes/main");
    assert_eq!(local_tip, tracking_tip);

    let bare = open_repo(bare_dir.path());
    let bare_tip = ref_to_commit_oid(&bare, "refs/meta/main");
    assert_eq!(bare_tip, local_tip);
}

#[test]
fn setup_missing_dot_git_meta_bails_with_hint() {
    let (dir, _sha) = setup_repo();

    harness::git_meta(dir.path())
        .args(["setup"])
        .assert()
        .failure()
        .stderr(predicate::str::contains("no .git-meta file found"))
        .stderr(predicate::str::contains("--init"));
}

#[test]
fn setup_empty_dot_git_meta_bails_with_hint() {
    let (dir, _sha) = setup_repo();
    std::fs::write(
        dir.path().join(".git-meta"),
        "# only a comment\n# another comment\n",
    )
    .unwrap();

    harness::git_meta(dir.path())
        .args(["setup"])
        .assert()
        .failure()
        .stderr(predicate::str::contains(
            "empty or contains no metadata remote URL",
        ));
}

/// `CLICOLOR_FORCE=1` must surface the colorized "Using" step label so
/// users on a terminal can visually distinguish setup phases. We rely
/// on the underlying `remote add --init` test for the rest of the
/// pipeline; this test only verifies the [`commands::setup`] surface.
#[test]
fn setup_emits_ansi_color_when_forced() {
    let (dir, _sha) = setup_repo();
    let bare_dir = TempDir::new().unwrap();
    let _ = gix::init_bare(bare_dir.path()).unwrap();
    let bare_path = bare_dir.path().to_str().unwrap();
    std::fs::write(dir.path().join(".git-meta"), format!("{bare_path}\n")).unwrap();

    harness::git_meta(dir.path())
        .env_remove("NO_COLOR")
        .env("CLICOLOR_FORCE", "1")
        .args(["setup"])
        .assert()
        .success()
        .stderr(predicate::str::contains("\x1b[1;36mUsing\x1b[0m"))
        .stderr(predicate::str::contains("\x1b[2m"))
        .stdout(predicate::str::contains("\x1b[1;32mAdded\x1b[0m"));
}

/// Default capture mode: stdout/stderr are pipes, so no ANSI escape
/// sequences should leak into the captured output.
#[test]
fn setup_omits_ansi_color_when_not_a_tty() {
    let (dir, _sha) = setup_repo();
    let bare_dir = TempDir::new().unwrap();
    let _ = gix::init_bare(bare_dir.path()).unwrap();
    let bare_path = bare_dir.path().to_str().unwrap();
    std::fs::write(dir.path().join(".git-meta"), format!("{bare_path}\n")).unwrap();

    harness::git_meta(dir.path())
        .env_remove("CLICOLOR_FORCE")
        .args(["setup"])
        .assert()
        .success()
        .stderr(predicate::str::contains("\x1b[").not())
        .stdout(predicate::str::contains("\x1b[").not());
}

#[test]
fn setup_ignores_comments_and_extra_lines() {
    let (dir, _sha) = setup_repo();
    let bare_dir = TempDir::new().unwrap();
    let _ = gix::init_bare(bare_dir.path()).unwrap();
    let bare_path = bare_dir.path().to_str().unwrap();

    let contents = format!(
        "# Pin the metadata remote for this project.\n\
         # Anyone running `git meta setup` here picks it up automatically.\n\
         \n\
         {bare_path}\n\
         \n\
         # Trailing notes are ignored.\n"
    );
    std::fs::write(dir.path().join(".git-meta"), contents).unwrap();

    harness::git_meta(dir.path())
        .args(["setup"])
        .assert()
        .success();

    let bare = open_repo(bare_dir.path());
    let _ = ref_to_commit_oid(&bare, "refs/meta/main");
}