svg-ultralight 0.50.1__py3-none-any.whl → 0.51.0__py3-none-any.whl

svg_ultralight/attrib_hints.py

@@ -5,9 +5,10 @@
 """
 
 from collections.abc import Mapping
+from typing import TypeAlias
 
 # Types svg_ultralight can format to pass through to lxml constructors.
-ElemAttrib = str | float | None
+ElemAttrib: TypeAlias = str | float | None
 
 # Type for an optional dictionary of element attributes.
-OptionalElemAttribMapping = Mapping[str, ElemAttrib] | None
+OptionalElemAttribMapping: TypeAlias = Mapping[str, ElemAttrib] | None

svg_ultralight/bounding_boxes/padded_text_initializers.py

@@ -23,11 +23,12 @@ to 16px.
 from __future__ import annotations
 
 from copy import deepcopy
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, overload
 
 from svg_ultralight.bounding_boxes.type_padded_text import PaddedText
 from svg_ultralight.constructors import new_element, update_element
 from svg_ultralight.font_tools.font_info import (
+    FTFontInfo,
     get_padded_text_info,
     get_svg_font_attributes,
 )
@@ -99,6 +100,7 @@ def pad_text(
     return PaddedText(text_elem, bbox, tpad, rpad, bpad, lpad)
 
 
+@overload
 def pad_text_ft(
     font: str | os.PathLike[str],
     text: str,
@@ -109,11 +111,38 @@ def pad_text_ft(
     y_bounds_reference: str | None = None,
     attrib: OptionalElemAttribMapping = None,
     **attributes: ElemAttrib,
-) -> PaddedText:
+) -> PaddedText: ...
+
+
+@overload
+def pad_text_ft(
+    font: str | os.PathLike[str],
+    text: list[str],
+    font_size: float | None = None,
+    ascent: float | None = None,
+    descent: float | None = None,
+    *,
+    y_bounds_reference: str | None = None,
+    attrib: OptionalElemAttribMapping = None,
+    **attributes: ElemAttrib,
+) -> list[PaddedText]: ...
+
+
+def pad_text_ft(
+    font: str | os.PathLike[str],
+    text: str | list[str],
+    font_size: float | None = None,
+    ascent: float | None = None,
+    descent: float | None = None,
+    *,
+    y_bounds_reference: str | None = None,
+    attrib: OptionalElemAttribMapping = None,
+    **attributes: ElemAttrib,
+) -> PaddedText | list[PaddedText]:
     """Create a new PaddedText instance using fontTools.
 
     :param font: path to a font file.
-    :param text: the text of the text element.
+    :param text: the text of the text element or a list of text strings.
     :param font_size: the font size to use.
     :param ascent: the ascent of the font. If not provided, it will be calculated
         from the font file.
@@ -130,7 +159,8 @@ def pad_text_ft(
     :param attributes: additional attributes to set on the text element. There is a
         chance these will cause the font element to exceed the BoundingBox of the
         PaddedText instance.
-    :return: a PaddedText instance with a line_gap defined.
+    :return: a PaddedText instance with a line_gap defined. If a list of strings is
+        given for parameter `text`, a list of PaddedText instances is returned.
     """
     attributes.update(attrib or {})
     attributes_ = format_attr_dict(**attributes)
@@ -142,11 +172,33 @@ def pad_text_ft(
     _ = attributes_.pop("font-weight", None)
     _ = attributes_.pop("font-stretch", None)
 
-    info = get_padded_text_info(
-        font, text, font_size, ascent, descent, y_bounds_reference=y_bounds_reference
-    )
-    elem = info.new_element(**attributes_)
-    return PaddedText(elem, info.bbox, *info.padding, info.line_gap)
+    font_info = FTFontInfo(font)
+
+    try:
+        input_one_text_item = False
+        if isinstance(text, str):
+            input_one_text_item = True
+            text = [text]
+
+        elems: list[PaddedText] = []
+        for text_item in text:
+            text_info = get_padded_text_info(
+                font_info,
+                text_item,
+                font_size,
+                ascent,
+                descent,
+                y_bounds_reference=y_bounds_reference,
+            )
+            elem = text_info.new_element(**attributes_)
+            elems.append(
+                PaddedText(elem, text_info.bbox, *text_info.padding, text_info.line_gap)
+            )
+    finally:
+        font_info.font.close()
+    if input_one_text_item:
+        return elems[0]
+    return elems
 
 
 def pad_text_mix(

svg_ultralight/constructors/new_element.py

@@ -13,14 +13,16 @@ from __future__ import annotations
 
 import copy
 import warnings
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, cast
 
 from lxml import etree
 
 from svg_ultralight.string_conversion import set_attributes
 
 if TYPE_CHECKING:
-    from lxml.etree import QName
+    from lxml.etree import (
+        QName,
+    )
     from lxml.etree import (
         _Element as EtreeElement,  # pyright: ignore[reportPrivateUsage]
     )
@@ -78,7 +80,10 @@ def new_sub_element(
         >>> etree.tostring(parent)
         b'<g><rect/></g>'
     """
-    elem = etree.SubElement(parent, tag)
+    elem = cast(
+        "EtreeElement",
+        etree.SubElement(parent, tag),  # pyright: ignore[reportUnknownMemberType]
+    )
     set_attributes(elem, **attributes)
     return elem
 

svg_ultralight/font_tools/font_info.py

@@ -644,7 +644,7 @@ def get_font_size_given_height(font: str | os.PathLike[str], height: float) -> f
 
 
 def get_padded_text_info(
-    font: str | os.PathLike[str],
+    font: str | os.PathLike[str] | FTFontInfo,
     text: str,
     font_size: float | None = None,
     ascent: float | None = None,
@@ -669,7 +669,10 @@ def get_padded_text_info(
     :return: A FTTextInfo object with the information necessary to create a
         PaddedText instance: bbox, tpad, rpad, bpad, lpad.
     """
-    font_info = FTFontInfo(font)
+    if isinstance(font, FTFontInfo):
+        font_info = font
+    else:
+        font_info = FTFontInfo(font)
     if y_bounds_reference:
         capline_info = FTTextInfo(font_info, y_bounds_reference, font_size)
         ascent = -capline_info.bbox.y

svg_ultralight/layout.py

@@ -7,11 +7,12 @@
 from __future__ import annotations
 
 from collections.abc import Sequence
+from typing import TypeAlias
 
 from svg_ultralight.string_conversion import format_number
 from svg_ultralight.unit_conversion import Measurement, MeasurementArg
 
-PadArg = float | str | Measurement | Sequence[float | str | Measurement]
+PadArg: TypeAlias = float | str | Measurement | Sequence[float | str | Measurement]
 
 
 def expand_pad_arg(pad: PadArg) -> tuple[float, float, float, float]:

svg_ultralight/transformations.py

@@ -9,7 +9,7 @@ from __future__ import annotations
 import numbers
 import re
 from contextlib import suppress
-from typing import TYPE_CHECKING, cast
+from typing import TYPE_CHECKING, TypeAlias, cast
 
 from svg_ultralight.strings import svg_matrix
 
@@ -21,7 +21,7 @@ if TYPE_CHECKING:
 
 RE_MATRIX = re.compile(r"matrix\(([^)]+)\)")
 
-_Matrix = tuple[float, float, float, float, float, float]
+_Matrix: TypeAlias = tuple[float, float, float, float, float, float]
 
 
 def mat_dot(mat1: _Matrix, mat2: _Matrix) -> _Matrix:

{svg_ultralight-0.50.1.dist-info → svg_ultralight-0.51.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: svg-ultralight
-Version: 0.50.1
+Version: 0.51.0
 Summary: a sensible way to create svg files with Python
 Author: Shay Hill
 Author-email: Shay Hill <shay_public@hotmail.com>

{svg_ultralight-0.50.1.dist-info → svg_ultralight-0.51.0.dist-info}/RECORD

@@ -1,22 +1,22 @@
 svg_ultralight/__init__.py,sha256=8orueEcPcbBPmtiK9BSCIEswqaBHxNREN6E4CIg1bEY,2732
 svg_ultralight/animate.py,sha256=pwboos8Z1GFNEGxHxIeeIyxyfRUew5pus2lG3P4MERU,1093
-svg_ultralight/attrib_hints.py,sha256=6nHzZG9Zup8SNtmQhHsSgptHxuGAiOJUr4Y82PONT84,368
+svg_ultralight/attrib_hints.py,sha256=_p85b77mcmj15IUnsDtgbYJ3FFd-Q1qM2OERv2UEZ20,419
 svg_ultralight/bounding_boxes/__init__.py,sha256=YNCwgN-Ja2MFoCxIYxC3KZTCx_gFvPfRQ-8zBR5Q9mk,73
 svg_ultralight/bounding_boxes/bound_helpers.py,sha256=o_NlH3bBU6lvn8KPTvp7hrEDb5OLqwO3t-gc51d44Rk,6583
-svg_ultralight/bounding_boxes/padded_text_initializers.py,sha256=9keGI3g6F92dqQEtwHnoVrNrDBREXWmomvzeSnnaY2Q,8594
+svg_ultralight/bounding_boxes/padded_text_initializers.py,sha256=7LD7VzmDSaNA2S9QTW0sNzMwLpjjReWGV0e5f4uglk8,10002
 svg_ultralight/bounding_boxes/supports_bounds.py,sha256=zoJr7goYEbiVsr5Vl2RlqCsbyBe5RHZGrU0B5WMBRbY,4427
 svg_ultralight/bounding_boxes/type_bound_collection.py,sha256=vzZPJoUg4Joaj7nTl4VpDFFHihIoBfBNvu6IaIprYKM,2582
 svg_ultralight/bounding_boxes/type_bound_element.py,sha256=CdbL48NMauCX5qZGlJes3aYFZHyVE3rby99HN-Kr7GI,2147
 svg_ultralight/bounding_boxes/type_bounding_box.py,sha256=81tyPpCHxRH1CXELO_qSCtueCyHYWBeEJO_JIxpl88Q,13101
 svg_ultralight/bounding_boxes/type_padded_text.py,sha256=1IV0DGjxem8celN4GAT8l60fLYhJwsES3O4tkHG7v60,14248
 svg_ultralight/constructors/__init__.py,sha256=fb-A50G3YTZNMQXpxcCl_QAcfssS0Us065_kdJRybDQ,313
-svg_ultralight/constructors/new_element.py,sha256=GIyvgJtMm8yrc_3P9HpA9IEhnsYdfnTV8p1TKWz_Ij0,3414
+svg_ultralight/constructors/new_element.py,sha256=hVQG7WBHQoTUmGiZNtVadGOitdTFBrHOQeVKKVOWGaA,3526
 svg_ultralight/font_tools/__init__.py,sha256=b_VSvk5aODzS2wv48EMU2sey_mxq1o1SL8ecWTdy4kc,78
 svg_ultralight/font_tools/comp_results.py,sha256=KR6RtVGWjGGfHX2d_-XRx_Jr9CQ36kPbQxLVK1yzgTI,10421
-svg_ultralight/font_tools/font_info.py,sha256=OclOKrt38FN-3-mk71eCh-aTtcyrb8lzZdCamI0_msg,29243
+svg_ultralight/font_tools/font_info.py,sha256=9nSj8qjzbT3bEe2Qgr-Rtfzb6RyFFCiXHbvv4Oyfxw0,29332
 svg_ultralight/image_ops.py,sha256=cwR038ECUuiceIrk-9Peh5Ijp4tzjuaV5Y1cvYOt4TI,5454
 svg_ultralight/inkscape.py,sha256=_aQ42ZQ1JP9TFdHmtxgCRsXvxfZPpdZWTGKEea9BgIU,9336
-svg_ultralight/layout.py,sha256=ScngctQtTuMmFo9KoFDv0eq4i5N-XJKruFB-G6yQ8FI,12474
+svg_ultralight/layout.py,sha256=yiTAYtSsYywdCObIdjkK3A4fiEYLNPqD3BOQKxfj6gQ,12514
 svg_ultralight/main.py,sha256=T5S2vtLU99JTVH1RucsWmQPlyltruWmQBMXAZEKbuok,7178
 svg_ultralight/metadata.py,sha256=kBaJ2QPpCn1s2f-qBGJxivA3HXoGTVKp4sU3-U0SQMw,4112
 svg_ultralight/nsmap.py,sha256=3N-x2I1iJ4EPWjYxIyHi4z8MVbJzxUyRvaGsiOijqmA,1208
@@ -27,8 +27,8 @@ svg_ultralight/root_elements.py,sha256=N4BBO1j2iUDIGbk70FRrtfElZo0AG-3Olqugxz7LD
 svg_ultralight/string_conversion.py,sha256=pzqkbGb-wXdhGd8ojEx4Hy-HBCC8fOfcloaLrNMh8TM,8607
 svg_ultralight/strings/__init__.py,sha256=iaRwr9AF9bPDkG3XvgGRSf8JPAS2GQ8ds9yCNpPN4ng,365
 svg_ultralight/strings/svg_strings.py,sha256=XlXQ5RqueGrROXBI4VzR2cK7e1NdNhYx5S84bgyqFUQ,3132
-svg_ultralight/transformations.py,sha256=A1kj-uMVUsVFdxr11Bkh8UpUpdot72JcligeyFF2ajY,4303
+svg_ultralight/transformations.py,sha256=fnPMdMQFgT6OEUIDwb_A7tvuILraPFW1jR9I1RaI1cA,4325
 svg_ultralight/unit_conversion.py,sha256=Y32GZ5TLkvjDHM2kBw52M8ZxDNlpVSlDkSdRa1S_X-A,8985
-svg_ultralight-0.50.1.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-svg_ultralight-0.50.1.dist-info/METADATA,sha256=dd4fuX_2jJdJSgINiD0UZm3TQ9vOiI2Q4e5k8x8RhTw,8691
-svg_ultralight-0.50.1.dist-info/RECORD,,
+svg_ultralight-0.51.0.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+svg_ultralight-0.51.0.dist-info/METADATA,sha256=qvOlGkyOA8KxGifWkMETlzsu--3Nf8qFCyqhet7VoyM,8691
+svg_ultralight-0.51.0.dist-info/RECORD,,