ratto 0.12.0

Ratatui-powered terminal primitives for shell dashboards: flicker-free repaints, progress bars, prompts, and portable time tools
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

use anyhow::{Context, anyhow};
use jiff::Timestamp;
use jiff::tz::TimeZone;

use crate::core::duration::format_compact;

/// Accepts "now", integer epoch seconds, or RFC3339/ISO8601.
pub fn parse_timestamp(s: &str) -> anyhow::Result<Timestamp> {
    let trimmed = s.trim();
    if trimmed.is_empty() {
        return Err(anyhow!("empty timestamp"));
    }
    if trimmed == "now" {
        return Ok(Timestamp::now());
    }
    if trimmed
        .strip_prefix('-')
        .unwrap_or(trimmed)
        .chars()
        .all(|c| c.is_ascii_digit())
    {
        let secs: i64 = trimmed.parse().context("parsing epoch seconds")?;
        return Timestamp::from_second(secs).context("epoch out of range");
    }
    trimmed
        .parse::<Timestamp>()
        .with_context(|| format!("invalid timestamp: {trimmed:?}"))
}

/// strftime formatting in UTC or the system zone.
pub fn format_timestamp(ts: Timestamp, fmt: &str, utc: bool) -> anyhow::Result<String> {
    let zone = if utc {
        TimeZone::UTC
    } else {
        TimeZone::system()
    };
    let zoned = ts.to_zoned(zone);
    jiff::fmt::strtime::format(fmt, &zoned).with_context(|| format!("invalid format: {fmt:?}"))
}

/// "5m ago" / "in 1h 33m" / "just now" (within ten seconds).
pub fn relative(from: Timestamp, to: Timestamp) -> String {
    let delta = to.as_second() - from.as_second();
    if delta.abs() < 10 {
        return "just now".to_string();
    }
    if delta < 0 {
        format!("{} ago", format_compact(-delta))
    } else {
        format!("in {}", format_compact(delta))
    }
}

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

    const EPOCH: i64 = 1785067200; // 2026-07-26T12:00:00Z

    #[test]
    fn parses_rfc3339_and_epoch_and_now() {
        assert_eq!(
            parse_timestamp("2026-07-26T12:00:00Z").unwrap().as_second(),
            EPOCH
        );
        assert_eq!(parse_timestamp("1785067200").unwrap().as_second(), EPOCH);
        let now = parse_timestamp("now").unwrap();
        assert!(now.as_second() > EPOCH - 86400 * 365 * 10);
        assert!(parse_timestamp("garbage").is_err());
        assert!(parse_timestamp("").is_err());
    }

    #[test]
    fn formats_in_utc() {
        let ts = parse_timestamp("1785067200").unwrap();
        assert_eq!(format_timestamp(ts, "%H:%M", true).unwrap(), "12:00");
        assert_eq!(format_timestamp(ts, "%s", true).unwrap(), "1785067200");
        assert_eq!(
            format_timestamp(ts, "%Y-%m-%d", true).unwrap(),
            "2026-07-26"
        );
    }

    #[test]
    fn relative_phrases() {
        let now = parse_timestamp("1785067200").unwrap();
        let past = parse_timestamp(&(EPOCH - 300).to_string()).unwrap();
        let future = parse_timestamp(&(EPOCH + 5580).to_string()).unwrap();
        assert_eq!(relative(now, past), "5m ago");
        assert_eq!(relative(now, future), "in 1h 33m");
        assert_eq!(relative(now, now), "just now");
    }
}