twjsrs 0.1.0

(De)serialize TiddlyWiki tiddlers to and from their JSON format.
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

use std::collections::HashMap;

use chrono::NaiveDateTime;

use crate::raw::RawTiddler;

pub mod time;
pub mod titles;

/// Errors that can arise when converting from a [`RawTiddler`] to a
/// [`Tiddler`].
#[derive(Debug, thiserror::Error)]
pub enum Error {
    #[error("time parse error")]
    Time(#[from] time::Error),
    #[error("title list parse error")]
    Titles(#[from] titles::Error),
}

/// Tiddler represented with idiomatic Rust data structures.
#[derive(Debug, Eq, PartialEq)]
pub struct Tiddler {
    pub created: Option<NaiveDateTime>,
    pub creator: Option<String>,
    pub fields: HashMap<String, String>,
    pub modified: NaiveDateTime,
    pub modifier: String,
    pub tags: Vec<String>,
    pub text: Option<String>,
    pub title: String,
}

fn optional_time(ot: Option<String>) -> Result<Option<NaiveDateTime>, time::Error> {
    match ot {
        None => Ok(None),
        Some(s) => Ok(Some(time::parse(&s)?)),
    }
}

impl Tiddler {
    /// Parse the information in a [`RawTiddler`].
    pub fn from_raw(raw: RawTiddler) -> Result<Self, Error> {
        Ok(Tiddler {
            created: optional_time(raw.created)?,
            creator: raw.creator,
            fields: raw.fields,
            modified: time::parse(&raw.modified)?,
            modifier: raw.modifier,
            tags: titles::parse(&raw.tags.unwrap_or_default())?,
            text: raw.text,
            title: raw.title,
        })
    }
}

// impl Tiddler {
//     pub fn raw(&self) -> RawTiddler {
//         RawTiddler {
//             created: todo!(),
//             creator: todo!(),
//             fields: self.fields,
//             modified: todo!(),
//             modifier: self.modifier,
//             tags: todo!(),
//             text: self.text,
//             title: self.title,
//         }
//     }
// }

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

    #[test]
    fn deserialize() {
        let serialized = "{
            \"created\": \"20220131074400001\",
            \"creator\": \"user\",
            \"text\": \"text\",
            \"tags\": \"tag [[second tag]]\",
            \"title\": \"Title\",
            \"modified\": \"20220131074400001\",
            \"modifier\": \"user\"
        }";
        let _tiddler: RawTiddler = serde_json::from_str(&serialized).unwrap();
    }
}