yog 0.0.47

yog: the standalone server for litany loops — the world, the balls and the conversations, behind one wire
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

//! **How a byte gets written** — the four primitives every writer above spends,
//! each answering a failure as a sentence naming its own path.
//!
//! **Nothing here panics.** A fixture that aborted mid-lay would leave a
//! half-world a harness then renders, so every effect is a `Result` and the
//! whole lay stops on the first one.
//!
//! The only `git` that runs is [`crate::git_env::git`] with both config homes
//! pointed at `/dev/null`: a fixture commit must not read the operator's
//! `core.hooksPath`, and a `GIT_DIR` inherited from a hook would land these
//! commits in the outer repo — the scrub `git_env` exists for.

use std::fs;
use std::path::Path;

/// Backdate `path` to `unix` seconds.
pub(super) fn stamp(path: &Path, unix: i64) -> Result<(), String> {
    let when = std::time::UNIX_EPOCH + std::time::Duration::from_secs(unix.unsigned_abs());
    let times = fs::FileTimes::new().set_modified(when);
    fs::File::options()
        .write(true)
        .open(path)
        .and_then(|f| f.set_times(times))
        .map_err(|e| format!("stamp {}: {e}", path.display()))
}

pub(super) fn mkdir(path: &Path) -> Result<(), String> {
    fs::create_dir_all(path).map_err(|e| format!("create {}: {e}", path.display()))
}

pub(super) fn write(path: &Path, body: &str) -> Result<(), String> {
    if let Some(parent) = path.parent() {
        mkdir(parent)?;
    }
    fs::write(path, body).map_err(|e| format!("write {}: {e}", path.display()))
}

pub(super) fn display(path: &Path) -> String {
    path.display().to_string()
}

/// One `git`, config-free and optionally dated. `when` stamps both the author
/// and committer dates in git's raw format, which is what makes two runs of one
/// recipe produce the same commit graph.
pub(super) fn git(dir: &Path, args: &[&str], when: Option<i64>) -> Result<(), String> {
    let mut cmd = crate::git_env::git();
    cmd.env("GIT_CONFIG_GLOBAL", "/dev/null");
    cmd.env("GIT_CONFIG_SYSTEM", "/dev/null");
    cmd.env("GIT_AUTHOR_NAME", "yog fixture");
    cmd.env("GIT_AUTHOR_EMAIL", "fixture@yog.invalid");
    cmd.env("GIT_COMMITTER_NAME", "yog fixture");
    cmd.env("GIT_COMMITTER_EMAIL", "fixture@yog.invalid");
    if let Some(unix) = when {
        let stamp = format!("@{unix} +0000");
        cmd.env("GIT_AUTHOR_DATE", &stamp);
        cmd.env("GIT_COMMITTER_DATE", &stamp);
    }
    let status = crate::git_env::status(cmd.arg("-C").arg(dir).args(args))
        .map_err(|e| format!("git {args:?}: {e}"))?;
    if status.success() {
        Ok(())
    } else {
        Err(format!("git {args:?}: {status}"))
    }
}

#[cfg(test)]
mod tests;