svg-ultralight 0.31.0__py3-none-any.whl → 0.32.0__py3-none-any.whl

svg_ultralight/import_svg.py

@@ -0,0 +1,50 @@
+"""Import an svg file as a BoundElement.
+
+:author: Shay Hill
+:created: 2024-05-28
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from lxml import etree
+
+from svg_ultralight.bounding_boxes.type_bound_element import BoundElement
+from svg_ultralight.bounding_boxes.type_bounding_box import BoundingBox
+from svg_ultralight.constructors import new_element
+
+if TYPE_CHECKING:
+    import os
+
+    from lxml.etree import _Element as EtreeElement  # type: ignore
+
+
+def _get_bounds_from_viewbox(root: EtreeElement) -> BoundingBox:
+    """Get the BoundingBox from the viewbox attribute of the root element.
+
+    :param root: The root element of the svg.
+    :return: The BoundingBox of the svg.
+    """
+    viewbox = root.attrib.get("viewBox")
+    if viewbox is None:
+        msg = "SVG file has no viewBox attribute. Failed to create BoundingBox."
+        raise ValueError(msg)
+    x, y, width, height = map(float, viewbox.split())
+    return BoundingBox(x, y, width, height)
+
+
+def import_svg(svg: str | os.PathLike[str]) -> BoundElement:
+    """Import an svg file as a BoundElement.
+
+    :param svg: The path to the svg file.
+    :return: The BoundElement representation of the svg.
+
+    The viewbox of the svg is used to create the BoundingBox of the BoundElement.
+    """
+    tree = etree.parse(svg)
+    root = tree.getroot()
+    bbox = _get_bounds_from_viewbox(root)
+    root_as_elem = new_element("g")
+    root_as_elem.extend(root)
+    return BoundElement(root_as_elem, bbox)

svg_ultralight/layout.py

@@ -99,7 +99,7 @@ def _infer_scale(
     * print_h == 0 / viewbox_h > 0
 
     The print area is invalid, but there is special handling for this. Interpret
-    viewbox units as print_w.native_unit and determe print area from viewbox area 1
+    viewbox units as print_w.native_unit and determine print area from viewbox area 1
     to 1.
 
         >>> _infer_scale(Measurement("in"), Measurement("in"), 1, 2)

{svg_ultralight-0.31.0.dist-info → svg_ultralight-0.32.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: svg-ultralight
-Version: 0.31.0
+Version: 0.32.0
 Summary: a sensible way to create svg files with Python
 Author-email: Shay Hill <shay_public@hotmail.com>
 License: MIT

{svg_ultralight-0.31.0.dist-info → svg_ultralight-0.32.0.dist-info}/RECORD

@@ -1,7 +1,8 @@
 svg_ultralight/__init__.py,sha256=iuI06A3lFqv0L7EoUfaKqYDg-z0HUlxPATBavtOmexs,2181
 svg_ultralight/animate.py,sha256=fE-zRU_uFrZIL9W78fcGz7qmrts8fz5UoWEy7b4xb44,1144
+svg_ultralight/import_svg.py,sha256=TVLbinch2g0RN-OlWyGXoQEO6vc2I_LsMXpOchwTJzE,1548
 svg_ultralight/inkscape.py,sha256=M8yTxXOu4NlXnhsMycvEJiIDpnDeiZ_bZakJBM38ZoU,9152
-svg_ultralight/layout.py,sha256=TTETT_8WLBXnQxDGXdAeczCFN5pFo5kKY3Q6zv4FPX4,12238
+svg_ultralight/layout.py,sha256=RBFJl6cIN6BYqXea5powEl2A4ZIxUJ0mtVoURkSZy_E,12240
 svg_ultralight/main.py,sha256=6oNkZfD27UMdP-oYqp5agS_IGcYb8NkUZwM9Zdyb3SA,7287
 svg_ultralight/metadata.py,sha256=Mxgxrxe1Ar4kp2wTT29aadxgHNFaaNLABo29jStiWDg,4201
 svg_ultralight/nsmap.py,sha256=y63upO78Rr-JJT56RWWZuyrsILh6HPoY4GhbYnK1A0g,1244
@@ -22,7 +23,7 @@ svg_ultralight/constructors/__init__.py,sha256=YcnO0iBQc19aL8Iemw0Y452MBMBIT2AN5
 svg_ultralight/constructors/new_element.py,sha256=VtMz9sPn9rMk6rui5Poysy3vezlOaS-tGIcGbu-SXmY,3406
 svg_ultralight/strings/__init__.py,sha256=Zalrf-ThFz7b7xKELx5lb2gOlBgV-6jk_k_EeSdVCVk,295
 svg_ultralight/strings/svg_strings.py,sha256=RYKMxOHq9abbZyGcFqsElBGLrBX-EjjNxln3s_ibi30,1296
-svg_ultralight-0.31.0.dist-info/METADATA,sha256=6YvGWvgRIhX1HBnCfDHetPdcHyFJPxs-jojK7Ch9h4M,8871
-svg_ultralight-0.31.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-svg_ultralight-0.31.0.dist-info/top_level.txt,sha256=se-6yqM_0Yg5orJKvKWdjQZ4iR4G_EjhL7oRgju-fdY,15
-svg_ultralight-0.31.0.dist-info/RECORD,,
+svg_ultralight-0.32.0.dist-info/METADATA,sha256=9WclLO21GeJDItp9VbWfeYHgzJ60q-w0-aEjjmnPf6A,8871
+svg_ultralight-0.32.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+svg_ultralight-0.32.0.dist-info/top_level.txt,sha256=se-6yqM_0Yg5orJKvKWdjQZ4iR4G_EjhL7oRgju-fdY,15
+svg_ultralight-0.32.0.dist-info/RECORD,,