feat: add text property to Shape and SlidePlaceholder classes for improved text handling

Author: ya7010

src/tppt/pptx/shape/__init__.py

@@ -41,6 +41,14 @@ class Shape(BaseShape[GenericPptxShape]):
     def __init__(self, pptx_shape: GenericPptxShape) -> None:
         self._pptx: GenericPptxShape = pptx_shape
 
+    @property
+    def text(self) -> str:
+        return self._pptx.text
+
+    @text.setter
+    def text(self, text: str) -> None:
+        self._pptx.text = text
+
     @property
     def text_frame(self) -> "TextFrame":
         from ..text.text_frame import TextFrame

src/tppt/pptx/shape/placeholder.py

@@ -1,11 +1,11 @@
-import datetime
 from typing import Self
 
 from pptx.shapes.placeholder import LayoutPlaceholder as PptxLayoutPlaceholder
 from pptx.shapes.placeholder import SlidePlaceholder as PptxSlidePlaceholder
 
-from tppt.exception import InvalidSetterTypeError
+from tppt.pptx.converter import to_pptx_length, to_tppt_length
 from tppt.pptx.presentation import PptxConvertible
+from tppt.types._length import Length
 
 from . import BaseShape
 
@@ -15,22 +15,36 @@ def __init__(self, pptx_obj: PptxSlidePlaceholder) -> None:
         self._pptx = pptx_obj
 
     @property
-    def text(self) -> str:
-        return self._pptx.text
-
-    @text.setter
-    def text(self, text: str | int | datetime.date | None):
-        match text:
-            case None:
-                return
-            case str():
-                self._pptx.text = text
-            case int():
-                self._pptx.text = str(text)
-            case datetime.date():
-                self._pptx.text = text.isoformat()
-            case _:
-                raise InvalidSetterTypeError(str, type(text))
+    def left(self) -> Length | None:
+        return to_tppt_length(self._pptx.left)
+
+    @left.setter
+    def left(self, value: Length | None) -> None:
+        self._pptx.left = to_pptx_length(value)
+
+    @property
+    def top(self) -> Length | None:
+        return to_tppt_length(self._pptx.top)
+
+    @top.setter
+    def top(self, value: Length | None) -> None:
+        self._pptx.top = to_pptx_length(value)
+
+    @property
+    def height(self) -> Length | None:
+        return to_tppt_length(self._pptx.height)
+
+    @height.setter
+    def height(self, value: Length | None) -> None:
+        self._pptx.height = to_pptx_length(value)
+
+    @property
+    def width(self) -> Length | None:
+        return to_tppt_length(self._pptx.width)
+
+    @width.setter
+    def width(self, value: Length | None) -> None:
+        self._pptx.width = to_pptx_length(value)
 
     def to_pptx(self) -> PptxSlidePlaceholder:
         return self._pptx