fix: rename placeholder property from 'value' to 'text' for consistency

Author: ya7010

examples/custom_slide_master.py

@@ -34,8 +34,8 @@ class CustomSlideMaster(tppt.SlideMaster):
         .build()
     )
     top_slide = presentation.slides[0]
-    top_slide.placeholders[0].value = "Custom Master Top Title"
-    top_slide.placeholders[1].value = "Custom Master Top Subtitle"
+    top_slide.placeholders[0].text = "Custom Master Top Title"
+    top_slide.placeholders[1].text = "Custom Master Top Subtitle"
 
     presentation.save(Path(__file__).with_suffix(".pptx"))
 

src/tppt/pptx/placeholder.py

@@ -13,22 +13,22 @@ def __init__(self, pptx_obj: PptxSlidePlaceholder) -> None:
         self._pptx = pptx_obj
 
     @property
-    def value(self) -> str:
+    def text(self) -> str:
         return self._pptx.text
 
-    @value.setter
-    def value(self, value: str | int | datetime.date | None):
-        match value:
+    @text.setter
+    def text(self, text: str | int | datetime.date | None):
+        match text:
             case None:
                 return
             case str():
-                self._pptx.text = value
+                self._pptx.text = text
             case int():
-                self._pptx.text = str(value)
+                self._pptx.text = str(text)
             case datetime.date():
-                self._pptx.text = value.isoformat()
+                self._pptx.text = text.isoformat()
             case _:
-                raise InvalidSetterTypeError(str, type(value))
+                raise InvalidSetterTypeError(str, type(text))
 
     def to_pptx(self) -> PptxSlidePlaceholder:
         return self._pptx

src/tppt/template/slide_layout.py

@@ -152,7 +152,7 @@ def placeholder_registry(slide: Slide):
             for placeholder, value in zip(
                 slide.placeholders, get_placeholders(self._slide_layout).values()
             ):
-                placeholder.value = value
+                placeholder.text = value
 
         return SlideBuilder(
             self._convertible_slide_layout,