timeglyph 0.3.0

Forensic timestamp decipherment — decode, encode, and identify the many ways systems inscribe time, with scored, cited, ambiguity-first interpretation.
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

//! CSV enrichment: add human-readable timestamp columns to a CSV, either by
//! auto-detecting numeric timestamp columns or by explicit column→format
//! conversion, optionally replacing the original column.
#![allow(clippy::unwrap_used, clippy::expect_used)]

use timeglyph::csv_enrich::{enrich, Conversion, EnrichOptions};
use timeglyph::RenderZone;

fn header(csv: &str) -> String {
    csv.lines().next().unwrap_or_default().to_string()
}

#[test]
fn explicit_conversion_adds_column_to_the_right() {
    let input = "id,created\n1,1577836800\n2,1583020800\n";
    let opts = EnrichOptions {
        conversions: vec![Conversion {
            column: "created".into(),
            format: "unix".into(),
        }],
        auto: false,
        replace: false,
        zone: RenderZone::Utc,
    };
    let out = enrich(input, &opts).unwrap();
    // New column appears immediately to the right of the source column.
    assert!(
        header(&out).contains("created,created_unix"),
        "header: {}",
        header(&out)
    );
    // Original value preserved, formatted value added.
    assert!(out.contains("1577836800"), "{out}");
    assert!(out.contains("2020-01-01T00:00:00Z"), "{out}");
    assert!(out.contains("2020-03-01T00:00:00Z"), "{out}");
}

#[test]
fn replace_option_replaces_the_original_column() {
    let input = "id,created\n1,1577836800\n";
    let opts = EnrichOptions {
        conversions: vec![Conversion {
            column: "created".into(),
            format: "unix".into(),
        }],
        auto: false,
        replace: true,
        zone: RenderZone::Utc,
    };
    let out = enrich(input, &opts).unwrap();
    assert_eq!(header(&out), "id,created", "header unchanged on replace");
    assert!(out.contains("2020-01-01T00:00:00Z"), "{out}");
    assert!(
        !out.contains("1577836800"),
        "original value must be replaced"
    );
}

#[test]
fn auto_detects_a_unix_seconds_column() {
    let input = "name,ts\na,1577836800\nb,1583020800\n";
    let opts = EnrichOptions {
        conversions: vec![],
        auto: true,
        replace: false,
        zone: RenderZone::Utc,
    };
    let out = enrich(input, &opts).unwrap();
    assert!(header(&out).contains("ts_unix"), "header: {}", header(&out));
    assert!(out.contains("2020-01-01T00:00:00Z"), "{out}");
}

#[test]
fn auto_skips_small_numeric_columns() {
    // 5 and 42 are far too small to be plausible timestamps — must NOT be
    // enriched (a count column, not a time column).
    let input = "id,count\n1,5\n2,42\n";
    let opts = EnrichOptions {
        conversions: vec![],
        auto: true,
        replace: false,
        zone: RenderZone::Utc,
    };
    let out = enrich(input, &opts).unwrap();
    assert_eq!(
        header(&out),
        "id,count",
        "small numeric column must be skipped"
    );
}