aven 0.1.7

Local-first task manager CLI and sync server
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

use time::format_description::well_known::Rfc3339;
use time::{OffsetDateTime, UtcOffset};

pub(super) fn local_timestamp_display(value: &str) -> String {
    let Ok(datetime) = OffsetDateTime::parse(value, &Rfc3339) else {
        return value.to_string();
    };
    let Ok(offset) = UtcOffset::local_offset_at(datetime) else {
        return value.to_string();
    };
    timestamp_display_in_offset(datetime, offset).unwrap_or_else(|| value.to_string())
}

pub(super) fn optional_local_timestamp_display(value: Option<&str>, fallback: &str) -> String {
    value
        .map(local_timestamp_display)
        .unwrap_or_else(|| fallback.to_string())
}

fn timestamp_display_in_offset(datetime: OffsetDateTime, offset: UtcOffset) -> Option<String> {
    datetime
        .to_offset(offset)
        .format(&time::macros::format_description!(
            "[year]-[month]-[day] [hour]:[minute]:[second]"
        ))
        .ok()
}

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

    #[test]
    fn timestamp_display_uses_given_offset() {
        let datetime = OffsetDateTime::parse("2026-07-04T06:43:06Z", &Rfc3339).unwrap();
        let offset = UtcOffset::from_hms(2, 0, 0).unwrap();

        assert_eq!(
            timestamp_display_in_offset(datetime, offset).unwrap(),
            "2026-07-04 08:43:06"
        );
    }

    #[test]
    fn local_timestamp_display_keeps_unparsed_values() {
        assert_eq!(
            local_timestamp_display("not-a-timestamp"),
            "not-a-timestamp"
        );
    }

    #[test]
    fn optional_local_timestamp_display_uses_fallback_for_absent_values() {
        assert_eq!(optional_local_timestamp_display(None, "never"), "never");
    }
}