laser-pdf 0.5.0

A Rust library for programmatic PDF generation with precise, predictable layout control.
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

use serde::{Deserializer, de::Visitor};

pub fn deserialize_buffer<'de, D: Deserializer<'de>>(deserializer: D) -> Result<Vec<u8>, D::Error> {
    struct FileVisitor;

    impl<'de> Visitor<'de> for FileVisitor {
        type Value = Vec<u8>;

        fn expecting(&self, formatter: &mut std::fmt::Formatter) -> std::fmt::Result {
            formatter.write_str("a valid path")
        }

        fn visit_str<E: serde::de::Error>(self, v: &str) -> Result<Self::Value, E> {
            std::fs::read(v).map_err(|e| E::custom(e))
        }

        fn visit_borrowed_str<E: serde::de::Error>(self, v: &'de str) -> Result<Self::Value, E> {
            std::fs::read(v).map_err(|e| E::custom(e))
        }

        fn visit_string<E: serde::de::Error>(self, v: String) -> Result<Self::Value, E> {
            std::fs::read(v).map_err(|e| E::custom(e))
        }
    }

    Ok(deserializer.deserialize_str(FileVisitor)?)
}

pub fn deserialize_svg<'de, D: Deserializer<'de>>(deserializer: D) -> Result<usvg::Tree, D::Error> {
    struct SvgVisitor;

    impl<'de> Visitor<'de> for SvgVisitor {
        type Value = usvg::Tree;

        fn expecting(&self, formatter: &mut std::fmt::Formatter) -> std::fmt::Result {
            formatter.write_str("a valid svg")
        }

        fn visit_str<E: serde::de::Error>(self, v: &str) -> Result<Self::Value, E> {
            usvg::Tree::from_str(v, &Default::default()).map_err(|e| E::custom(e))
        }

        fn visit_borrowed_str<E: serde::de::Error>(self, v: &'de str) -> Result<Self::Value, E> {
            usvg::Tree::from_str(v, &Default::default()).map_err(|e| E::custom(e))
        }

        fn visit_string<E: serde::de::Error>(self, v: String) -> Result<Self::Value, E> {
            usvg::Tree::from_str(&v, &Default::default()).map_err(|e| E::custom(e))
        }
    }

    Ok(deserializer.deserialize_str(SvgVisitor)?)
}

pub fn deserialize_svg_from_path<'de, D: Deserializer<'de>>(
    deserializer: D,
) -> Result<usvg::Tree, D::Error> {
    struct SvgVisitor;

    impl<'de> Visitor<'de> for SvgVisitor {
        type Value = usvg::Tree;

        fn expecting(&self, formatter: &mut std::fmt::Formatter) -> std::fmt::Result {
            formatter.write_str("a valid svg")
        }

        fn visit_str<E: serde::de::Error>(self, v: &str) -> Result<Self::Value, E> {
            let data = std::fs::read(v).map_err(|e| E::custom(e))?;
            usvg::Tree::from_data(&data, &Default::default()).map_err(|e| E::custom(e))
        }

        fn visit_borrowed_str<E: serde::de::Error>(self, v: &'de str) -> Result<Self::Value, E> {
            let data = std::fs::read(v).map_err(|e| E::custom(e))?;
            usvg::Tree::from_data(&data, &Default::default()).map_err(|e| E::custom(e))
        }

        fn visit_string<E: serde::de::Error>(self, v: String) -> Result<Self::Value, E> {
            let data = std::fs::read(v).map_err(|e| E::custom(e))?;
            usvg::Tree::from_data(&data, &Default::default()).map_err(|e| E::custom(e))
        }
    }

    Ok(deserializer.deserialize_str(SvgVisitor)?)
}

#[derive(Clone)]
pub enum Image {
    Svg(usvg::Tree),
    Pixel(image::DynamicImage),
}

pub fn deserialize_image<'de, D: Deserializer<'de>>(deserializer: D) -> Result<Image, D::Error> {
    struct ImageVisitor;

    fn visit<E: serde::de::Error>(path: impl AsRef<std::path::Path>) -> Result<Image, E> {
        if path.as_ref().extension().map_or(false, |e| e == "svg") {
            Ok(Image::Svg({
                let data = std::fs::read(path).map_err(|e| E::custom(e))?;
                usvg::Tree::from_data(&data, &Default::default()).map_err(|e| E::custom(e))?
            }))
        } else {
            Ok(Image::Pixel(image::open(path).map_err(E::custom)?))
        }
    }

    impl<'de> Visitor<'de> for ImageVisitor {
        type Value = Image;

        fn expecting(&self, formatter: &mut std::fmt::Formatter) -> std::fmt::Result {
            formatter.write_str("a valid image")
        }

        fn visit_str<E: serde::de::Error>(self, v: &str) -> Result<Self::Value, E> {
            visit(v)
        }

        fn visit_borrowed_str<E: serde::de::Error>(self, v: &'de str) -> Result<Self::Value, E> {
            visit(v)
        }

        fn visit_string<E: serde::de::Error>(self, v: String) -> Result<Self::Value, E> {
            visit(v)
        }
    }

    Ok(deserializer.deserialize_str(ImageVisitor)?)
}