ps-python-pptx 1.2.0__py3-none-any.whl → 1.3.0__py3-none-any.whl

pptx/__init__.py

@@ -26,7 +26,7 @@ from pptx.parts.slide import (
 if TYPE_CHECKING:
     from pptx.opc.package import Part
 
-__version__ = "1.2.0"
+__version__ = "1.3.0"
 
 sys.modules["pptx.exceptions"] = exceptions
 del sys

pptx/action.py

@@ -237,6 +237,29 @@ class Hyperlink(Subshape):
             hlink = self._get_or_add_hlink()
             hlink.rId = rId
 
+    @property
+    def screen_tip(self) -> str | None:
+        """Text shown by PowerPoint when pointing at this hyperlink.
+
+        Assign the address or action before setting a ScreenTip. Assigning None
+        or an empty string removes the tip without changing the link. Setting
+        a new address uses the existing address setter behavior and clears the
+        old tip. Reading this property does not create a hyperlink element.
+        """
+        hlink = self._hlink
+        return hlink.tooltip if hlink is not None else None
+
+    @screen_tip.setter
+    def screen_tip(self, value: str | None):
+        if value is not None and not isinstance(value, str):
+            raise TypeError("screen_tip must be a string or None")
+        hlink = self._hlink
+        if hlink is None:
+            if value:
+                raise ValueError("Set a hyperlink address or action before its ScreenTip")
+            return
+        hlink.tooltip = value or None
+
     def _get_or_add_hlink(self) -> CT_Hyperlink:
         """Get the `a:hlinkClick` or `a:hlinkHover` element for the Hyperlink object.
 

pptx/oxml/action.py

@@ -14,6 +14,8 @@ class CT_Hyperlink(BaseOxmlElement):
         "action", XsdString
     )
 
+    tooltip: str | None = OptionalAttribute("tooltip", XsdString)  # pyright: ignore[reportAssignmentType]
+
     @property
     def action_fields(self) -> dict[str, str]:
         """Query portion of the `ppaction://` URL as dict.

pptx/text/text.py

@@ -488,6 +488,29 @@ class _Hyperlink(Subshape):
         if url:
             self._add_hlinkClick(url)
 
+    @property
+    def screen_tip(self) -> str | None:
+        """Text shown by PowerPoint when pointing at this hyperlink.
+
+        Assign the address or action before setting a ScreenTip. Assigning None
+        or an empty string removes the tip without changing the link. Setting
+        a new address uses the existing address setter behavior and clears the
+        old tip. Reading this property does not create a hyperlink element.
+        """
+        hlink = self._hlinkClick
+        return hlink.tooltip if hlink is not None else None
+
+    @screen_tip.setter
+    def screen_tip(self, value: str | None):
+        if value is not None and not isinstance(value, str):
+            raise TypeError("screen_tip must be a string or None")
+        hlink = self._hlinkClick
+        if hlink is None:
+            if value:
+                raise ValueError("Set a hyperlink address or action before its ScreenTip")
+            return
+        hlink.tooltip = value or None
+
     def _add_hlinkClick(self, url: str):
         rId = self.part.relate_to(url, RT.HYPERLINK, is_external=True)
         self._rPr.add_hlinkClick(rId)

{ps_python_pptx-1.2.0.dist-info → ps_python_pptx-1.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ps-python-pptx
-Version: 1.2.0
+Version: 1.3.0
 Summary: Python-pptx fork with public APIs for themes, backgrounds, lists, and rich text.
 Author-email: Steve Canny <stcanny@gmail.com>
 License: MIT

{ps_python_pptx-1.2.0.dist-info → ps_python_pptx-1.3.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
-pptx/__init__.py,sha256=OVJQ5p8HC3OgSKBarTUvWI58cFrKHFPQc32rD0Vft8A,2168
-pptx/action.py,sha256=NiaoG75EYyLemHYUkV5zNB93ZwS5A39uTY9I_K0P_b0,9638
+pptx/__init__.py,sha256=27NcYHHKRAjL6gwwhRTPjktz_rkm-r4G8yD-zYFNn6I,2168
+pptx/action.py,sha256=PuhHYNENNLNYgecril8rDJIERaJEyCb8kbPK4QdyKNM,10597
 pptx/api.py,sha256=IrGxa35Z6tyZBxaBuknyROdmHKNI8XUa77XU62xBFFM,1737
 pptx/background.py,sha256=1-YI6g_bOJppM_cuAhHEJXOaKTzh7endTaVOE-wAEaU,8732
 pptx/exc.py,sha256=5ahr42pL5ELGHFD0YFCAYp17YEm_DkXUymyt2ENFX_Q,473
@@ -50,7 +50,7 @@ pptx/opc/serialized.py,sha256=7iH3v3Ln95W26P1C0XYswvPONdwTp-hM_ld7QB5lXHQ,11437
 pptx/opc/shared.py,sha256=moVes6J3hp4BrXQTZfkoVJldxfr9LUzMtxhtl6nkYOw,709
 pptx/opc/spec.py,sha256=Adxgld3M-kTbWTwm27YNwPUPl7Ajh3anXTiwgYLbIDo,998
 pptx/oxml/__init__.py,sha256=m3tZMaKa9C7d-zm6NRQATenNq3uHPc65_DPeBOdPB24,15869
-pptx/oxml/action.py,sha256=XM8-gextGC6bTP4RCZHoDDfO-8qBaVpq6fuhSLjYhFA,1612
+pptx/oxml/action.py,sha256=1hP_zInNiI_U0q7gqoWYOAS0tTYJhQfbJ68xW92gYIU,1720
 pptx/oxml/coreprops.py,sha256=Q32m6gMBqlH2WA7XtXBxD60vdWY1DEuFJQX2w8CjfFw,10419
 pptx/oxml/ns.py,sha256=En3N2dpK2eJb_E7w5korgxrYEDU_yFkHdpPR5eDkzLU,4761
 pptx/oxml/presentation.py,sha256=sh2DAaEg5PdIV3vXIeeX4RgJIALZ4UbRqDOF9hUFvV4,4252
@@ -110,9 +110,9 @@ pptx/templates/xlsx-icon.emf,sha256=FOUpNs698W5aZinOcHQVwmEi_lSvMihyotJf7GGKae4,
 pptx/text/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pptx/text/fonts.py,sha256=dvkIW1jTVR2PbsAblB-lNA0xYkp86VeUKJC6DOCbu3c,12863
 pptx/text/layout.py,sha256=bkZjiRmoIrFMlcmonoROfgfgrgLCc9BRXKiCkWwB7W0,10232
-pptx/text/text.py,sha256=IxVURbpxvWCfof7607RSJO2eJqwoX0bqLSY1Nfmoopg,28472
-ps_python_pptx-1.2.0.dist-info/licenses/LICENSE,sha256=dlLyceRtDVM-ncRj87X8vcrPTWqcjWtVTRXv0PN_YTI,1104
-ps_python_pptx-1.2.0.dist-info/METADATA,sha256=BQAW54v7YBwG5oDgVU0jC6oAkzN3G1NSEUQLuIJZfKc,3273
-ps_python_pptx-1.2.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-ps_python_pptx-1.2.0.dist-info/top_level.txt,sha256=O4BUPv9c3_6OQNtaneqNqq32Dp1TFyKK-K9CVNPenF8,5
-ps_python_pptx-1.2.0.dist-info/RECORD,,
+pptx/text/text.py,sha256=7QW0zRa_pwnuJaT95Ip5fp0zAqmjH8wQRPKpP6avs18,29441
+ps_python_pptx-1.3.0.dist-info/licenses/LICENSE,sha256=dlLyceRtDVM-ncRj87X8vcrPTWqcjWtVTRXv0PN_YTI,1104
+ps_python_pptx-1.3.0.dist-info/METADATA,sha256=EaaZ4AHmoQPz4q3jQErrCVx--fBRigh_e8OuX-hXQzY,3273
+ps_python_pptx-1.3.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+ps_python_pptx-1.3.0.dist-info/top_level.txt,sha256=O4BUPv9c3_6OQNtaneqNqq32Dp1TFyKK-K9CVNPenF8,5
+ps_python_pptx-1.3.0.dist-info/RECORD,,