svg-ultralight 0.45.3__tar.gz → 0.45.5__tar.gz

{svg_ultralight-0.45.3/src/svg_ultralight.egg-info → svg_ultralight-0.45.5}/PKG-INFO

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

{svg_ultralight-0.45.3 → svg_ultralight-0.45.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "svg-ultralight"
-version = "0.45.3"
+version = "0.45.5"
 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.3"
+version = "0.45.5"
 tag_format = "$version"
 version_files = ["pyproject.toml:^version"]
 annotated_tag = true

{svg_ultralight-0.45.3 → svg_ultralight-0.45.5}/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.3 → svg_ultralight-0.45.5}/src/svg_ultralight/image_ops.py

@@ -70,7 +70,7 @@ def _symmetric_crop(
 
 
 def _crop_image_to_bbox_ratio(
-    image: ImageType, bbox: BoundingBox, center: tuple[float, float] | None = None
+    image: ImageType, bbox: BoundingBox, center: tuple[float, float] | None
 ) -> ImageType:
     """Crop an image to the ratio of a bounding box.
 
@@ -116,8 +116,8 @@ def _get_svg_embedded_image_str(image: ImageType) -> str:
 
 def new_image_elem_in_bbox(
     filename: str | os.PathLike[str],
-    bbox: BoundingBox,
-    center: tuple[float, float] | None,
+    bbox: BoundingBox | None = None,
+    center: tuple[float, float] | None = None,
 ) -> EtreeElement:
     """Create a new svg image element inside a bounding box.
 
@@ -128,6 +128,9 @@ def new_image_elem_in_bbox(
         (0.4, 0.5) would crop 20% off the right side of the image.
     :return: an etree image element with the cropped image embedded
     """
+    image = Image.open(filename)
+    if bbox is None:
+        bbox = BoundingBox(0, 0, image.width, image.height)
     image = _crop_image_to_bbox_ratio(Image.open(filename), bbox, center)
     svg_image = new_element("image", **bbox_dict(bbox))
     svg_image.set(

{svg_ultralight-0.45.3 → svg_ultralight-0.45.5/src/svg_ultralight.egg-info}/PKG-INFO

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

svg_ultralight-0.45.5/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)

svg_ultralight-0.45.3/tests/test_bound_element.py

@@ -1,31 +0,0 @@
-"""Test methods for BoundElement instances.
-
-:author: Shay Hill
-:created: 2025-07-29
-"""
-
-from svg_ultralight.bounding_boxes.type_bounding_box import BoundingBox
-
-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)
-
-
-