typst-as-lib 0.16.0

Small wrapper for typst that makes it easier to use it as a templating engine
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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

use typst::{
    foundations::Bytes,
    syntax::{FileId, RootedPath, Source, VirtualPath, VirtualRoot, package::PackageSpec},
    text::Font,
};

/// Converts types into a Typst [`FileId`].
pub trait IntoFileId {
    /// Converts into a file ID.
    fn into_file_id(self) -> FileId
    where
        Self: std::marker::Sized;
}

impl IntoFileId for FileId {
    fn into_file_id(self) -> FileId {
        self
    }
}

impl IntoFileId for &str {
    fn into_file_id(self) -> FileId {
        let vpath = VirtualPath::new(self).expect("valid virtual path");
        RootedPath::new(VirtualRoot::Project, vpath).intern()
    }
}

impl IntoFileId for (PackageSpec, &str) {
    fn into_file_id(self) -> FileId {
        let (p, id) = self;
        let vpath = VirtualPath::new(id).expect("valid virtual path");
        RootedPath::new(VirtualRoot::Package(p), vpath).intern()
    }
}

/// Converts types into a Typst [`Source`].
pub trait IntoSource {
    /// Converts into a source file.
    fn into_source(self) -> Source
    where
        Self: std::marker::Sized;
}

impl IntoSource for Source {
    fn into_source(self) -> Source {
        self
    }
}

impl IntoSource for (&str, String) {
    fn into_source(self) -> Source {
        let (path, source) = self;
        let vpath = VirtualPath::new(path).expect("valid virtual path");
        let id = RootedPath::new(VirtualRoot::Project, vpath).intern();
        Source::new(id, source)
    }
}

impl IntoSource for (&str, &str) {
    fn into_source(self) -> Source {
        let (path, source) = self;
        (path, source.to_owned()).into_source()
    }
}

impl IntoSource for (FileId, String) {
    fn into_source(self) -> Source {
        let (id, source) = self;
        Source::new(id, source)
    }
}

impl IntoSource for (FileId, &str) {
    fn into_source(self) -> Source {
        let (id, source) = self;
        Source::new(id, source.to_owned())
    }
}

impl IntoSource for String {
    fn into_source(self) -> Source {
        Source::detached(self)
    }
}

impl IntoSource for &str {
    fn into_source(self) -> Source {
        Source::detached(self.to_owned())
    }
}

/// Converts types into Typst [`Bytes`].
pub trait IntoBytes {
    /// Converts into bytes.
    fn into_bytes(self) -> Bytes
    where
        Self: std::marker::Sized;
}

impl IntoBytes for &[u8] {
    fn into_bytes(self) -> Bytes {
        Bytes::new(self.to_vec())
    }
}

impl IntoBytes for Vec<u8> {
    fn into_bytes(self) -> Bytes {
        Bytes::new(self)
    }
}

impl IntoBytes for Bytes {
    fn into_bytes(self) -> Bytes {
        self
    }
}

/// Converts types into an iterator of Typst [`Font`]s.
pub trait IntoFonts
where
    Self: std::marker::Sized,
{
    /// Converts into an iterator of fonts.
    fn into_fonts(self) -> Box<dyn Iterator<Item = Font>>;
}

impl IntoFonts for &[u8] {
    fn into_fonts(self) -> Box<dyn Iterator<Item = Font>> {
        Box::new(Font::iter(Bytes::new(self.to_vec())))
    }
}

impl IntoFonts for Vec<u8> {
    fn into_fonts(self) -> Box<dyn Iterator<Item = Font>> {
        Box::new(Font::iter(Bytes::new(self)))
    }
}

impl IntoFonts for Font {
    fn into_fonts(self) -> Box<dyn Iterator<Item = Font>> {
        Box::new(std::iter::once(self))
    }
}

impl IntoFonts for Bytes {
    fn into_fonts(self) -> Box<dyn Iterator<Item = Font>> {
        Box::new(Font::iter(self))
    }
}