packtrack 3.0.1

A simple CLI for tracking mail packages
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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

use crate::Result;
use crate::cache::models::CacheEntry;
use std::collections::HashMap;

pub trait CacheEntrySerializer {
    fn serialize(
        &self,
        entries: &HashMap<String, Vec<CacheEntry>>,
    ) -> Result<String>;
    fn deserialize(
        &self,
        text: &str,
    ) -> Result<HashMap<String, Vec<CacheEntry>>>;
}

/// CacheEntry serializer which serializes to a JSON object with URLs as keys
/// and a list of CacheEntries as value:
///
/// {
///  "https://www.dhl.com/tracking/foo": [
///    {
///      "text": "some stringified JSON",
///      "created": "2025-05-17T08:01:05.307751675Z"
///    }
///  ],
///  "https://jouw.postnl.nl/track-and-trace/bar": [
///    {
///      "text": "some stringified JSON",
///      "created": "2026-01-11T21:38:16.037494234Z"
///    },
///    {
///      "text": "some stringified JSON",
///      "created": "2026-01-11T21:39:32.112309418Z"
///    },
///   ]
/// }
pub struct JsonCacheEntrySerializer;
impl CacheEntrySerializer for JsonCacheEntrySerializer {
    fn serialize(
        &self,
        entries: &HashMap<String, Vec<CacheEntry>>,
    ) -> Result<String> {
        Ok(serde_json::to_string_pretty(&entries)?)
    }
    fn deserialize(
        &self,
        text: &str,
    ) -> Result<HashMap<String, Vec<CacheEntry>>> {
        Ok(serde_json::from_str(text)?)
    }
}

#[cfg(test)]
mod tests {

    use crate::utils::UtcTime;

    use super::*;

    fn utc(s: &str) -> UtcTime {
        s.parse().unwrap()
    }

    #[test]
    fn test_json_serialize_deserialize() -> Result<()> {
        // Unfortunately, it is hard to test with more than 1 URL entry, because
        // the order of the HashMap is not guaranteed, and neither is the order
        // of the serialized output.
        let values = HashMap::from([(
            "url1".into(),
            vec![
                CacheEntry {
                    text:    "a".into(),
                    created: utc("2025-05-17T08:01:05.307751675Z"),
                },
                CacheEntry {
                    text:    "b".into(),
                    created: utc("2025-05-18T08:01:05.307751675Z"),
                },
            ],
        )]);
        let expected_serialized = r#"
{
  "url1": [
    {
      "text": "a",
      "created": "2025-05-17T08:01:05.307751675Z"
    },
    {
      "text": "b",
      "created": "2025-05-18T08:01:05.307751675Z"
    }
  ]
}"#
        .trim();

        let serialized = JsonCacheEntrySerializer.serialize(&values)?;
        assert_eq!(serialized, expected_serialized);

        let deserialized =
            JsonCacheEntrySerializer.deserialize(expected_serialized)?;
        assert_eq!(deserialized, values);

        Ok(())
    }
}