kladd 0.2.0

A weirdly personal markup language
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
107
108
109
110
111
112
113
114

use std::{error::Error, fmt::Display};

use crate::{ast::NodeKind, lexer::TokenKind};

#[derive(Debug, Clone, PartialEq, Eq)]
pub enum ParsingError {
    ParseError(&'static str),
    UnexpectedEnd,
    UnexpectedTokenKind(TokenKind, &'static str),
    UnexpectedToken(TokenKind, String, &'static str),
    InvalidAttribute(TokenKind),
    InvalidAttributeKind(TokenKind),
    MissingAttribute(&'static str, &'static str),
    InvalidHeading(String),
    MissingBlockEnd(String),
    MetadataDeserializationFailed(String),
}

impl Display for ParsingError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            ParsingError::ParseError(e) => write!(f, "{}", e),
            ParsingError::UnexpectedToken(token, name, desc) => {
                write!(
                    f,
                    "found {:?} with body {} in {} unexpectedly",
                    token, name, desc
                )
            }
            ParsingError::InvalidAttribute(kind) => {
                write!(f, "{:?} is not a valid attribute", kind)
            }
            ParsingError::InvalidAttributeKind(kind) => {
                write!(f, "{:?} is not valid as an attribute key", kind)
            }
            ParsingError::MissingAttribute(attr, name) => {
                write!(f, "attribute {} required in {}", attr, name)
            }
            ParsingError::InvalidHeading(_) => todo!(),
            ParsingError::UnexpectedTokenKind(token_kind, desc) => {
                write!(
                    f,
                    "found token kind {:?} in {} unexpectedly",
                    token_kind, desc
                )
            }
            ParsingError::UnexpectedEnd => write!(f, "unexpectedly reached the end of input"),
            ParsingError::MissingBlockEnd(name) => {
                write!(f, "did not reach the end of {} block", name)
            }
            ParsingError::MetadataDeserializationFailed(inner) => {
                write!(
                    f,
                    "metadata deserialization failed with serde error: {}",
                    inner
                )
            }
        }
    }
}

impl Error for ParsingError {}

impl From<ParsingError> for KladdError {
    fn from(value: ParsingError) -> Self {
        KladdError::ParsingError(value)
    }
}

impl From<toml::de::Error> for ParsingError {
    fn from(value: toml::de::Error) -> Self {
        ParsingError::MetadataDeserializationFailed(value.to_string())
    }
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub enum HtmlRenderError {
    InvalidNode(NodeKind, &'static str),
}

impl From<HtmlRenderError> for KladdError {
    fn from(value: HtmlRenderError) -> Self {
        KladdError::HtmlRenderError(value)
    }
}

impl Display for HtmlRenderError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Self::InvalidNode(node, name) => {
                write!(f, "found unexpected node {:?} in {}", node, name)
            }
        }
    }
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub enum KladdError {
    ParsingError(ParsingError),
    HtmlRenderError(HtmlRenderError),
}

impl Display for KladdError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            KladdError::ParsingError(e) => write!(f, "{}", e),
            KladdError::HtmlRenderError(e) => {
                write!(f, "{}", e)
            }
        }
    }
}

impl Error for KladdError {}