svgdom 0.10.3

Library to represent an SVG as a DOM.
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

// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.

use svgparser;
use simplecss;

use {
    ErrorPos,
};

// TODO: split to Dom errors and Parser errors

error_chain! {
    types {
        Error, ErrorKind, ResultExt, Result;
    }

    links {
        Xml(svgparser::Error, svgparser::ErrorKind) #[doc = "svgparser errors"];
    }

    errors {
        /// If you want to use referenced element inside link attribute,
        /// such element must have a non-empty ID.
        ElementMustHaveAnId {
            display("the element must have an id")
        }

        /// Linked nodes can't reference each other or itself.
        ///
        /// # Examples
        ///
        /// ```text
        /// <linearGradient id="lg1" xlink:href="#lg2"/>
        /// <linearGradient id="lg2" xlink:href="#lg1"/>
        /// ```
        ///
        /// or
        ///
        /// ```text
        /// <linearGradient id="lg1" xlink:href="#lg1"/>
        /// ```
        ElementCrosslink {
            display("element crosslink")
        }

        /// Parsed document must have an `svg` element.
        NoSvgElement {
            display("the document does not have an SVG element")
        }

        /// Parsed document must have at least one node.
        EmptyDocument {
            display("the document does not have any nodes")
        }

        /// *libsvgdom* didn't support most of the CSS2 spec.
        UnsupportedCSS(pos: ErrorPos) {
            display("unsupported CSS at {}", pos)
        }

        /// Error during parsing of the CSS2.
        InvalidCSS(pos: ErrorPos) {
            display("invalid CSS at {}", pos)
        }

        /// ENTITY with XML Element data is not supported.
        UnsupportedEntity(pos: ErrorPos) {
            display("unsupported ENTITY data at {}", pos)
        }

        /// We don't support a \<paint\> type with a fallback value and a valid FuncIRI.
        ///
        /// # Examples
        ///
        /// ```text
        /// <linearGradient id="lg1"/>
        /// <rect fill="url(#lg1) red"/>
        /// ```
        UnsupportedPaintFallback(iri: String) {
            display("valid FuncIRI(#{}) with fallback value is not supported", iri)
        }

        /// We don't support `use` elements with a broken filter attribute.
        BrokenFuncIri(iri: String) {
            display("the 'use' element with a broken filter attribute('#{}') is not supported", iri)
        }

        /// UTF-8 processing error.
        InvalidEncoding {
            display("the input data is not a valid UTF-8 string")
        }

        /// Failed to find an attribute, which must be set, during post-processing.
        MissingAttribute(name: String, value: String) {
            display("attribute '{}' is missing in the '{}' element", name, value)
        }

        /// simplecss errors.
        CssError(e: simplecss::Error) {
            display("{:?}", e)
        }
    }
}

impl From<simplecss::Error> for Error {
    fn from(value: simplecss::Error) -> Error {
        ErrorKind::CssError(value).into()
    }
}