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

use crate::error::Result;
use crate::runtime::Renderable;

use super::Language;
use super::TagTokenIter;

pub trait TagReflection {
    fn tag(&self) -> &str;

    fn description(&self) -> &str;

    fn example(&self) -> Option<&str> {
        None
    }

    fn spec(&self) -> Option<&str> {
        None
    }
}

/// A trait for creating custom tags. This is a simple type alias for a function.
///
/// This function will be called whenever the parser encounters a tag and returns
/// a new [Renderable] based on its parameters. The received parameters
/// specify the name of the tag, the argument [Tokens](crate::TagTokenIter) passed to
/// the tag and the global [`Language`].
pub trait ParseTag: Send + Sync + ParseTagClone {
    fn parse(&self, arguments: TagTokenIter, options: &Language) -> Result<Box<dyn Renderable>>;

    fn reflection(&self) -> &dyn TagReflection;
}

pub trait ParseTagClone {
    fn clone_box(&self) -> Box<dyn ParseTag>;
}

impl<T> ParseTagClone for T
where
    T: 'static + ParseTag + Clone,
{
    fn clone_box(&self) -> Box<dyn ParseTag> {
        Box::new(self.clone())
    }
}

impl Clone for Box<dyn ParseTag> {
    fn clone(&self) -> Box<dyn ParseTag> {
        self.clone_box()
    }
}

impl<T> From<T> for Box<dyn ParseTag>
where
    T: 'static + ParseTag,
{
    fn from(filter: T) -> Self {
        Box::new(filter)
    }
}