carte 0.6.0

Runs your apps' processes on demand behind *.localhost hostnames, one stack per git worktree
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

//! Wall-clock times as people read them.

/// `14:32:05` in the local time zone, for milliseconds since the Unix epoch.
pub fn local_hms(at_ms: u64) -> String {
    let secs = (at_ms / 1000) as libc::time_t;
    // SAFETY: `tm` is plain data that localtime_r fills in; both pointers are valid.
    let tm = unsafe {
        let mut tm: libc::tm = std::mem::zeroed();
        if libc::localtime_r(&secs, &mut tm).is_null() {
            return "--:--:--".to_string();
        }
        tm
    };
    format!("{:02}:{:02}:{:02}", tm.tm_hour, tm.tm_min, tm.tm_sec)
}

/// `14:32:05  acme-web@feature-x  stopped: idle for 15m`
pub fn event_line(event: &carte_api::Event) -> String {
    format!(
        "{}  {}  {}",
        local_hms(event.at_ms),
        event.subject_label(),
        event.summary()
    )
}

/// Milliseconds since the Unix epoch.
pub fn now_ms() -> u64 {
    std::time::SystemTime::now()
        .duration_since(std::time::UNIX_EPOCH)
        .map_or(0, |d| d.as_millis() as u64)
}

/// How long ago, roughly: `12s`, `3m`, `2h`, `4d`.
pub fn ago(at_ms: u64, now_ms: u64) -> String {
    let secs = now_ms.saturating_sub(at_ms) / 1000;
    match secs {
        0..60 => format!("{secs}s"),
        60..3600 => format!("{}m", secs / 60),
        3600..86400 => format!("{}h", secs / 3600),
        _ => format!("{}d", secs / 86400),
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn formats_a_time_of_day() {
        let hms = local_hms(1_700_000_000_000);
        assert_eq!(hms.len(), 8);
        assert_eq!(&hms[2..3], ":");
        assert_eq!(&hms[6..], "20");
    }

    #[test]
    fn rounds_ages_down_to_one_unit() {
        let now = 10_000_000_000;
        assert_eq!(ago(now - 5_000, now), "5s");
        assert_eq!(ago(now - 185_000, now), "3m");
        assert_eq!(ago(now - 2 * 3_600_000 - 1, now), "2h");
        assert_eq!(ago(now - 3 * 86_400_000, now), "3d");
        assert_eq!(ago(now + 1_000, now), "0s");
    }
}