# -*- coding: utf-8 -*- # # Copyright (c) 2020 Martin Owens # Sergei Izmailov # Thomas Holder # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. # """Utilities for parsing SVG documents. .. versionadded:: 1.2 Separated out from :py:mod:`inkex.elements._base`""" from collections import defaultdict from typing import DefaultDict, List, Any, Type, TYPE_CHECKING from lxml import etree if TYPE_CHECKING: from ..elements._base import BaseElement from ._utils import splitNS, addNS from ..utils import errormsg from ..localization import inkex_gettext as _ class NodeBasedLookup(etree.PythonElementClassLookup): """ We choose what kind of Elements we should return for each element, providing useful SVG based API to our extensions system. """ default: Type["BaseElement"] # (ns,tag) -> list(cls) ; ascending priority lookup_table: DefaultDict[str, List[Any]] = defaultdict() @classmethod def register_class(cls, klass): """Register the given class using it's attached tag name""" key = addNS(*splitNS(klass.tag_name)[::-1]) old = cls.lookup_table.get(key, []) old.append(klass) cls.lookup_table[key] = old @classmethod def find_class(cls, xpath): """Find the class for this type of element defined by an xpath .. versionadded:: 1.1""" if isinstance(xpath, type): return xpath for kls in cls.lookup_table[addNS(*splitNS(xpath.split("/")[-1])[::-1])]: # TODO: We could create a apply the xpath attrs to the test element # to narrow the search, but this does everything we need right now. test_element = kls() if kls.is_class_element(test_element): return kls raise KeyError(f"Could not find svg tag for '{xpath}'") def lookup(self, doc, element): # pylint: disable=unused-argument """Lookup called by lxml when assigning elements their object class""" try: try: options = self.lookup_table[element.tag] except KeyError: if not element.tag.startswith("{"): tag = addNS(*splitNS(element.tag)[::-1]) options = self.lookup_table[tag] else: return self.default for kls in reversed(options): if kls.is_class_element(element): # pylint: disable=protected-access return kls except AttributeError: # Handle return None return self.default SVG_PARSER = etree.XMLParser(huge_tree=True, strip_cdata=False, recover=True) SVG_PARSER.set_element_class_lookup(NodeBasedLookup()) def load_svg(stream): """Load SVG file using the SVG_PARSER""" if (isinstance(stream, str) and stream.lstrip().startswith("<")) or ( isinstance(stream, bytes) and stream.lstrip().startswith(b"<") ): parsed = etree.ElementTree(etree.fromstring(stream, parser=SVG_PARSER)) else: parsed = etree.parse(stream, parser=SVG_PARSER) if len(SVG_PARSER.error_log) > 0: errormsg( _( "A parsing error occurred, which means you are likely working with " "a non-conformant SVG file. The following errors were found:\n" ) ) for __, element in enumerate(SVG_PARSER.error_log): errormsg( _( "{error_message}. Line {line_number}, column {column_number}", ).format( error_message=element.message, line_number=element.line, column_number=element.column, ) ) errormsg( _( "\nProcessing will continue; however we encourage you to fix your" " file manually." ) ) return parsed