svg-ultralight 0.45.2__tar.gz → 0.45.4__tar.gz

{svg_ultralight-0.45.2/src/svg_ultralight.egg-info → svg_ultralight-0.45.4}/PKG-INFO

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

{svg_ultralight-0.45.2 → svg_ultralight-0.45.4}/dev-requirements.txt

@@ -91,7 +91,7 @@ questionary==2.1.0
     # via commitizen
 soupsieve==2.7
     # via beautifulsoup4
-svg-path-data==0.3.0
+svg-path-data==0.3.2
     # via svg-ultralight (pyproject.toml)
 termcolor==3.1.0
     # via commitizen
@@ -99,7 +99,7 @@ tomlkit==0.13.3
     # via commitizen
 tox==4.27.0
     # via svg-ultralight (pyproject.toml)
-types-html5lib==1.1.11.20250516
+types-html5lib==1.1.11.20250708
     # via types-lxml
 types-lxml==2025.3.30
     # via svg-ultralight (pyproject.toml)

{svg_ultralight-0.45.2 → svg_ultralight-0.45.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "svg-ultralight"
-version = "0.45.2"
+version = "0.45.4"
 description = "a sensible way to create svg files with Python"
 authors = [{ name = "Shay Hill", email = "shay_public@hotmail.com" }]
 license = { text = "MIT" }
@@ -53,7 +53,7 @@ convention = "pep257"
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "0.45.2"
+version = "0.45.4"
 tag_format = "$version"
 version_files = ["pyproject.toml:^version"]
 annotated_tag = true

{svg_ultralight-0.45.2 → svg_ultralight-0.45.4}/src/svg_ultralight/bounding_boxes/type_padded_text.py

@@ -64,6 +64,7 @@ enough to lay out text on a business card.
 
 from __future__ import annotations
 
+import math
 from typing import TYPE_CHECKING
 
 from paragraphs import par
@@ -223,6 +224,41 @@ class PaddedText(BoundElement):
         """
         self.base_bpad = value / self.unpadded_bbox.scale[1]
 
+    @property
+    def scale(self) -> tuple[float, float]:
+        """Get scale of the bounding box.
+
+        :return: uniform scale of the bounding box
+
+        Use caution, the scale attribute can cause errors in intuition. Changing
+        width or height will change the scale attribute, but not the x or y values.
+        The scale setter, on the other hand, will work in the tradational manner.
+        I.e., x => x*scale, y => y*scale, x2 => x*scale, y2 => y*scale, width =>
+        width*scale, height => height*scale, scale => scale*scale. This matches how
+        scale works in almost every other context.
+        """
+        xx, xy, yx, yy, *_ = self.unpadded_bbox.transformation
+        return math.sqrt(xx * xx + xy * xy), math.sqrt(yx * yx + yy * yy)
+
+    @scale.setter
+    def scale(self, value: tuple[float, float]) -> None:
+        """Scale the bounding box by a uniform factor.
+
+        :param value: new scale value
+
+        Don't miss this! You are setting the scale, not scaling the scale! If you
+        have a previously defined scale other than 1, this is probably not what you
+        want. Most of the time, you will want to use the *= operator.
+
+        `scale = 2` -> ignore whatever scale was previously defined and set scale to 2
+        `scale *= 2` -> make it twice as big as it was.
+        """
+        new_scale = (
+            value[0] / self.unpadded_bbox.scale[0],
+            value[1] / self.unpadded_bbox.scale[1],
+        )
+        self.transform(scale=new_scale)
+
     @property
     def width(self) -> float:
         """The width of this line of text with padding.

{svg_ultralight-0.45.2 → svg_ultralight-0.45.4}/src/svg_ultralight/transformations.py

@@ -6,6 +6,7 @@
 
 from __future__ import annotations
 
+import numbers
 import re
 from contextlib import suppress
 from typing import TYPE_CHECKING, cast
@@ -116,16 +117,16 @@ def new_transformation_matrix(
     """
     transformation = transformation or (1, 0, 0, 1, 0, 0)
 
-    if isinstance(scale, float):
+    if isinstance(scale, (float, int, numbers.Real)):
         scale_x, scale_y = (scale, scale)
     elif scale is None:
         scale_x, scale_y = (1, 1)
     else:
-        scale_x, scale_y = cast("tuple[float, float]", scale)
+        scale_x, scale_y = scale
 
     dx = dx or 0
     dy = dy or 0
-    return mat_dot((scale_x, 0, 0, scale_y, dx, dy), transformation)
+    return mat_dot((float(scale_x), 0, 0, float(scale_y), dx, dy), transformation)
 
 
 def transform_element(elem: EtreeElement, matrix: _Matrix) -> EtreeElement:

{svg_ultralight-0.45.2 → svg_ultralight-0.45.4/src/svg_ultralight.egg-info}/PKG-INFO

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

{svg_ultralight-0.45.2 → svg_ultralight-0.45.4}/src/svg_ultralight.egg-info/SOURCES.txt

@@ -44,6 +44,7 @@ src/svg_ultralight/strings/__init__.py
 src/svg_ultralight/strings/svg_strings.py
 tests/__init__.py
 tests/conftest.py
+tests/test_bound_element.py
 tests/test_bounding.py
 tests/test_inkscape.py
 tests/test_layout.py

svg_ultralight-0.45.4/tests/test_bound_element.py

@@ -0,0 +1,84 @@
+"""Test methods for BoundElement instances.
+
+:author: Shay Hill
+:created: 2025-07-29
+"""
+
+from svg_ultralight.bounding_boxes.type_bounding_box import BoundingBox
+from svg_ultralight.bounding_boxes.type_padded_text import PaddedText
+from svg_ultralight.bounding_boxes.type_bound_element import BoundElement
+from svg_ultralight.constructors import new_element
+
+
+class TestTransforms:
+    """Test methods for BoundElement instances."""
+
+    def test_matrix(self) -> None:
+        """Test the transform method."""
+        bbox = BoundingBox(0, 0, 100, 100)
+        bbox.transform(transformation=(1, 2, 3, 4, 5, 6))
+        assert bbox.transformation == (1, 2, 3, 4, 5, 6)
+
+    def test_scale_float(self) -> None:
+        """Test the scale method with a float."""
+        bbox = BoundingBox(0, 0, 100, 100)
+        bbox.transform(scale=2.0)
+        assert bbox.transformation == (2.0, 0.0, 0.0, 2.0, 0.0, 0.0)
+
+    def test_scale_int(self) -> None:
+        """Test the scale method with an int."""
+        bbox = BoundingBox(0, 0, 100, 100)
+        bbox.transform(scale=2)
+        assert bbox.transformation == (2.0, 0.0, 0.0, 2.0, 0.0, 0.0)
+
+
+class TestSetScale:
+    """Test methods for BoundElement instances."""
+
+    def test_sets_not_transforms(self) -> None:
+        """The new scale is the new scale, regardless of the old scale."""
+        bbox = BoundingBox(0, 0, 100, 100)
+        bbox.scale = (2, 2)
+        assert bbox.scale == (2.0, 2.0)
+        bbox.scale = (3, 3)
+        assert bbox.scale == (3.0, 3.0)
+
+
+class TestBoundElement:
+    """Test methods for BoundElement instances."""
+
+    def test_set_scale(self) -> None:
+        """Test the set_scale method."""
+        elem = new_element("rect", width=100, height=100)
+        bbox = BoundingBox(0, 0, 100, 100)
+        blem = BoundElement(elem, bbox)
+        blem.scale = (2, 2)
+        assert blem.scale == (2.0, 2.0)
+
+    def test_transform(self) -> None:
+        """Test the transform method."""
+        elem = new_element("rect", width=100, height=100)
+        bbox = BoundingBox(0, 0, 100, 100)
+        blem = BoundElement(elem, bbox)
+        blem.transform(scale=5)
+        assert blem.scale == (5.0, 5.0)
+
+
+class TestPaddedText:
+    """Text that padded text instances scale like bound elements."""
+
+    def test_set_scale(self) -> None:
+        """Test the set_scale method."""
+        elem = new_element("rect", width=100, height=100)
+        bbox = BoundingBox(0, 0, 100, 100)
+        blem = PaddedText(elem, bbox, 1, 2, 3, 4)
+        blem.scale = (2, 2)
+        assert blem.scale == (2.0, 2.0)
+
+    def test_transform(self) -> None:
+        """Test the transform method."""
+        elem = new_element("rect", width=100, height=100)
+        bbox = BoundingBox(0, 0, 100, 100)
+        blem = PaddedText(elem, bbox, 1, 2, 3, 4)
+        blem.transform(scale=5)
+        assert blem.scale == (5.0, 5.0)