splashboard 1.4.0

A customizable terminal splash screen with plugin-based data sources
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

#![cfg(test)]
//! Test-only repo builder shared by every git fetcher's tests. Uses the `git` CLI via
//! `std::process::Command` rather than gix write APIs so we don't need extra gix features just
//! for fixtures. CI runs with git installed (everywhere we care about).

use std::path::Path;
use std::process::Command;

use tempfile::TempDir;

pub fn make_repo() -> (TempDir, gix::Repository) {
    let tmp = tempfile::tempdir().expect("tempdir");
    run(tmp.path(), &["init", "-q", "-b", "main"]);
    run(tmp.path(), &["config", "user.email", "test@example.com"]);
    run(tmp.path(), &["config", "user.name", "Test"]);
    run(tmp.path(), &["config", "commit.gpgsign", "false"]);
    run(tmp.path(), &["config", "tag.gpgsign", "false"]);
    // Detach from the user's global excludes file so paths like `node_modules/` /
    // `vendor/` / `dist/` (commonly ignored globally) aren't silently skipped by
    // `git add` inside test repos.
    run(tmp.path(), &["config", "core.excludesfile", "/dev/null"]);
    let repo = gix::discover(tmp.path()).expect("discover");
    (tmp, repo)
}

pub fn commit(repo: &gix::Repository, msg: &str) {
    let path = repo.workdir().expect("workdir");
    let file = path.join("README.md");
    let prev = std::fs::read_to_string(&file).unwrap_or_default();
    std::fs::write(&file, format!("{prev}{msg}\n")).unwrap();
    run(path, &["add", "."]);
    run(path, &["commit", "-q", "-m", msg]);
}

pub fn commit_as(repo: &gix::Repository, msg: &str, author: &str, email: &str) {
    let path = repo.workdir().expect("workdir");
    let file = path.join("README.md");
    let prev = std::fs::read_to_string(&file).unwrap_or_default();
    std::fs::write(&file, format!("{prev}{msg}\n")).unwrap();
    run(path, &["add", "."]);
    run(
        path,
        &[
            "-c",
            &format!("user.name={author}"),
            "-c",
            &format!("user.email={email}"),
            "commit",
            "-q",
            "-m",
            msg,
        ],
    );
}

pub fn commit_touching(repo: &gix::Repository, file_rel: &str, msg: &str) {
    let path = repo.workdir().expect("workdir");
    let file = path.join(file_rel);
    if let Some(parent) = file.parent() {
        std::fs::create_dir_all(parent).ok();
    }
    let prev = std::fs::read_to_string(&file).unwrap_or_default();
    std::fs::write(&file, format!("{prev}{msg}\n")).unwrap();
    run(path, &["add", "."]);
    run(path, &["commit", "-q", "-m", msg]);
}

pub fn tag(repo: &gix::Repository, name: &str) {
    run(repo.workdir().unwrap(), &["tag", name]);
}

pub fn stash(repo: &gix::Repository) {
    let path = repo.workdir().unwrap();
    let file = path.join("README.md");
    let prev = std::fs::read_to_string(&file).unwrap_or_default();
    std::fs::write(&file, format!("{prev}wip\n")).unwrap();
    run(path, &["stash", "push", "--include-untracked", "-m", "wip"]);
}

pub fn dirty_write(repo: &gix::Repository, file_rel: &str, contents: &str) {
    let path = repo.workdir().unwrap();
    std::fs::write(path.join(file_rel), contents).unwrap();
}

fn run(dir: &Path, args: &[&str]) {
    let out = Command::new("git")
        .args(args)
        .current_dir(dir)
        .output()
        .expect("git should be on PATH for tests");
    assert!(
        out.status.success(),
        "git {args:?} failed: {}",
        String::from_utf8_lossy(&out.stderr)
    );
}