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

svg_ultralight/__init__.py

@@ -1,105 +1,108 @@
-"""Bring many of the svg_ultralight functions into the svg_ultralight namespace.
-
-:author: Shay Hill
-:created: 12/22/2019.
-"""
-
-from svg_ultralight.bounding_boxes.bound_helpers import (
-    bbox_dict,
-    cut_bbox,
-    new_bbox_rect,
-    new_bbox_union,
-    new_bound_union,
-    new_element_union,
-    pad_bbox,
-    parse_bound_element,
-)
-from svg_ultralight.bounding_boxes.padded_text_initializers import (
-    pad_text,
-    pad_text_ft,
-    pad_text_mix,
-)
-from svg_ultralight.bounding_boxes.supports_bounds import SupportsBounds
-from svg_ultralight.bounding_boxes.type_bound_collection import BoundCollection
-from svg_ultralight.bounding_boxes.type_bound_element import BoundElement
-from svg_ultralight.bounding_boxes.type_bounding_box import BoundingBox
-from svg_ultralight.bounding_boxes.type_padded_text import PaddedText
-from svg_ultralight.constructors.new_element import (
-    deepcopy_element,
-    new_element,
-    new_sub_element,
-    update_element,
-)
-from svg_ultralight.font_tools.comp_results import check_font_tools_alignment
-from svg_ultralight.inkscape import (
-    write_pdf,
-    write_pdf_from_svg,
-    write_png,
-    write_png_from_svg,
-    write_root,
-)
-from svg_ultralight.main import new_svg_root, write_svg
-from svg_ultralight.metadata import new_metadata
-from svg_ultralight.nsmap import NSMAP, new_qname
-from svg_ultralight.query import (
-    clear_svg_ultralight_cache,
-    get_bounding_box,
-    get_bounding_boxes,
-)
-from svg_ultralight.root_elements import new_svg_root_around_bounds
-from svg_ultralight.string_conversion import (
-    format_attr_dict,
-    format_number,
-    format_numbers,
-)
-from svg_ultralight.transformations import (
-    mat_apply,
-    mat_dot,
-    mat_invert,
-    transform_element,
-)
-
-__all__ = [
-    "NSMAP",
-    "BoundCollection",
-    "BoundElement",
-    "BoundingBox",
-    "PaddedText",
-    "SupportsBounds",
-    "bbox_dict",
-    "check_font_tools_alignment",
-    "clear_svg_ultralight_cache",
-    "cut_bbox",
-    "deepcopy_element",
-    "format_attr_dict",
-    "format_number",
-    "format_numbers",
-    "get_bounding_box",
-    "get_bounding_boxes",
-    "mat_apply",
-    "mat_dot",
-    "mat_invert",
-    "new_bbox_rect",
-    "new_bbox_union",
-    "new_bound_union",
-    "new_element",
-    "new_element_union",
-    "new_metadata",
-    "new_qname",
-    "new_sub_element",
-    "new_svg_root",
-    "new_svg_root_around_bounds",
-    "pad_bbox",
-    "pad_text",
-    "pad_text_ft",
-    "pad_text_mix",
-    "parse_bound_element",
-    "transform_element",
-    "update_element",
-    "write_pdf",
-    "write_pdf_from_svg",
-    "write_png",
-    "write_png_from_svg",
-    "write_root",
-    "write_svg",
-]
+"""Import functions into the package namespace.
+
+:author: ShayHill
+:created: 2019-12-22
+"""
+
+from svg_ultralight.bounding_boxes.bound_helpers import (
+    bbox_dict,
+    cut_bbox,
+    new_bbox_rect,
+    new_bbox_union,
+    new_bound_union,
+    new_element_union,
+    pad_bbox,
+    parse_bound_element,
+)
+from svg_ultralight.bounding_boxes.padded_text_initializers import (
+    pad_text,
+    pad_text_ft,
+    pad_text_mix,
+)
+from svg_ultralight.bounding_boxes.supports_bounds import SupportsBounds
+from svg_ultralight.bounding_boxes.type_bound_collection import BoundCollection
+from svg_ultralight.bounding_boxes.type_bound_element import BoundElement
+from svg_ultralight.bounding_boxes.type_bounding_box import BoundingBox
+from svg_ultralight.bounding_boxes.type_padded_text import PaddedText
+from svg_ultralight.constructors.new_element import (
+    deepcopy_element,
+    new_element,
+    new_sub_element,
+    update_element,
+)
+from svg_ultralight.font_tools.comp_results import check_font_tools_alignment
+from svg_ultralight.inkscape import (
+    write_pdf,
+    write_pdf_from_svg,
+    write_png,
+    write_png_from_svg,
+    write_root,
+)
+from svg_ultralight.main import new_svg_root, write_svg
+from svg_ultralight.metadata import new_metadata
+from svg_ultralight.nsmap import NSMAP, new_qname
+from svg_ultralight.query import (
+    clear_svg_ultralight_cache,
+    get_bounding_box,
+    get_bounding_boxes,
+)
+from svg_ultralight.read_svg import get_bounding_box_from_root, parse
+from svg_ultralight.root_elements import new_svg_root_around_bounds
+from svg_ultralight.string_conversion import (
+    format_attr_dict,
+    format_number,
+    format_numbers,
+)
+from svg_ultralight.transformations import (
+    mat_apply,
+    mat_dot,
+    mat_invert,
+    transform_element,
+)
+
+__all__ = [
+    "NSMAP",
+    "BoundCollection",
+    "BoundElement",
+    "BoundingBox",
+    "PaddedText",
+    "SupportsBounds",
+    "bbox_dict",
+    "check_font_tools_alignment",
+    "clear_svg_ultralight_cache",
+    "cut_bbox",
+    "deepcopy_element",
+    "format_attr_dict",
+    "format_number",
+    "format_numbers",
+    "get_bounding_box",
+    "get_bounding_box_from_root",
+    "get_bounding_boxes",
+    "mat_apply",
+    "mat_dot",
+    "mat_invert",
+    "new_bbox_rect",
+    "new_bbox_union",
+    "new_bound_union",
+    "new_element",
+    "new_element_union",
+    "new_metadata",
+    "new_qname",
+    "new_sub_element",
+    "new_svg_root",
+    "new_svg_root_around_bounds",
+    "pad_bbox",
+    "pad_text",
+    "pad_text_ft",
+    "pad_text_mix",
+    "parse",
+    "parse_bound_element",
+    "transform_element",
+    "update_element",
+    "write_pdf",
+    "write_pdf_from_svg",
+    "write_png",
+    "write_png_from_svg",
+    "write_root",
+    "write_svg",
+]

svg_ultralight/animate.py

@@ -1,40 +1,40 @@
-"""One script to animate a list of pngs.
-
-Requires: pillow, which is an optional project dependency.
-
-:author: Shay Hill
-:created: 7/26/2020
-"""
-
-from __future__ import annotations
-
-try:
-    from PIL import Image
-except ModuleNotFoundError as exc:
-    MSG = "`pip install pillow` to use svg_ultralight.animate module"
-    raise ModuleNotFoundError(MSG) from exc
-from typing import TYPE_CHECKING
-
-if TYPE_CHECKING:
-    import os
-    from collections.abc import Iterable
-
-
-def write_gif(
-    gif: str | os.PathLike[str],
-    pngs: Iterable[str] | Iterable[os.PathLike[str]] | Iterable[str | os.PathLike[str]],
-    duration: float = 100,
-    loop: int = 0,
-) -> None:
-    """Create a gif from a sequence of pngs.
-
-    :param gif: output filename (include .gif extension)
-    :param pngs: png filenames
-    :param duration: milliseconds per frame
-    :param loop: how many times to loop gif. 0 -> forever
-    :effects: write file to gif
-    """
-    images = [Image.open(x) for x in pngs]
-    images[0].save(
-        gif, save_all=True, append_images=images[1:], duration=duration, loop=loop
-    )
+"""One script to animate a list of pngs.
+
+Requires: pillow, which is an optional project dependency.
+
+:author: Shay Hill
+:created: 7/26/2020
+"""
+
+from __future__ import annotations
+
+try:
+    from PIL import Image
+except ModuleNotFoundError as exc:
+    MSG = "`pip install pillow` to use svg_ultralight.animate module"
+    raise ModuleNotFoundError(MSG) from exc
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    import os
+    from collections.abc import Iterable
+
+
+def write_gif(
+    gif: str | os.PathLike[str],
+    pngs: Iterable[str] | Iterable[os.PathLike[str]] | Iterable[str | os.PathLike[str]],
+    duration: float = 100,
+    loop: int = 0,
+) -> None:
+    """Create a gif from a sequence of pngs.
+
+    :param gif: output filename (include .gif extension)
+    :param pngs: png filenames
+    :param duration: milliseconds per frame
+    :param loop: how many times to loop gif. 0 -> forever
+    :effects: write file to gif
+    """
+    images = [Image.open(x) for x in pngs]
+    images[0].save(
+        gif, save_all=True, append_images=images[1:], duration=duration, loop=loop
+    )

svg_ultralight/attrib_hints.py

@@ -1,14 +1,13 @@
-"""Type hints for pass-through arguments to lxml constructors.
-
-:author: Shay Hill
-:created: 2025-07-09
-"""
-
-from collections.abc import Mapping
-from typing import Union
-
-# Types svg_ultralight can format to pass through to lxml constructors.
-ElemAttrib = Union[str, float, None]
-
-# Type for an optional dictionary of element attributes.
-OptionalElemAttribMapping = Union[Mapping[str, ElemAttrib], None]
+"""Type hints for pass-through arguments to lxml constructors.
+
+:author: Shay Hill
+:created: 2025-07-09
+"""
+
+from collections.abc import Mapping
+
+# Types svg_ultralight can format to pass through to lxml constructors.
+ElemAttrib = str | float | None
+
+# Type for an optional dictionary of element attributes.
+OptionalElemAttribMapping = Mapping[str, ElemAttrib] | None

svg_ultralight/bounding_boxes/__init__.py

@@ -1,5 +1,5 @@
-"""Help Pyright find types.
-
-:author: Shay Hill
-:created: 2023-02-02
-"""
+"""Help Pyright find types.
+
+:author: Shay Hill
+:created: 2023-02-02
+"""