python-pptx2 2.19.0__tar.gz → 2.20.0__tar.gz

{python_pptx2-2.19.0 → python_pptx2-2.20.0}/HISTORY.rst

@@ -15,12 +15,15 @@ can sit beside both ``python-pptx`` (``pptx``) and ``power-pptx``
 .. _`scanny/python-pptx`: https://github.com/scanny/python-pptx
 
 
-2.19.0 (2026-08-30)
+2.20.0 (2026-08-30)
 +++++++++++++++++++
 
 Added
 .....
 
+* CSS three-digit hex shorthand (``#888`` → ``#888888``) is accepted
+  anywhere a color hex string is.
+
 * **Agent-friendly kwargs, everywhere.** The alias/fuzzy normalization
   introduced for ``add_text`` now covers the whole shape-creation
   surface via a reusable ``@agent_friendly`` decorator: ``add_shape``

{python_pptx2-2.19.0/src/python_pptx2.egg-info → python_pptx2-2.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-pptx2
-Version: 2.19.0
+Version: 2.20.0
 Summary: Create, read, and update PowerPoint 2007+ (.pptx) files. Fork of power-pptx / python-pptx, published as python-pptx2.
 Author: Matěj Štágl
 Author-email: stagl@wattlescript.org

{python_pptx2-2.19.0 → python_pptx2-2.20.0}/src/pptx2/__init__.py

@@ -57,7 +57,7 @@ from pptx2.parts.slide import (
 if TYPE_CHECKING:
     from pptx2.opc.package import Part
 
-__version__ = "2.19.0"
+__version__ = "2.20.0"
 
 sys.modules["pptx2.exceptions"] = exceptions
 del sys

{python_pptx2-2.19.0 → python_pptx2-2.20.0}/src/pptx2/_color.py

@@ -41,6 +41,9 @@ def coerce_color(value: Any) -> RGBColor:
         return value
     if isinstance(value, str):
         s = value.lstrip("#")
+        if len(s) == 3:
+            # CSS shorthand: '#888' -> '#888888' (a common generator habit)
+            s = "".join(ch * 2 for ch in s)
         if len(s) != 6:
             raise ValueError(
                 "color hex string must be 6 digits "

{python_pptx2-2.19.0 → python_pptx2-2.20.0/src/python_pptx2.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-pptx2
-Version: 2.19.0
+Version: 2.20.0
 Summary: Create, read, and update PowerPoint 2007+ (.pptx) files. Fork of power-pptx / python-pptx, published as python-pptx2.
 Author: Matěj Štágl
 Author-email: stagl@wattlescript.org

{python_pptx2-2.19.0 → python_pptx2-2.20.0}/tests/test_shape_helpers.py

@@ -428,3 +428,12 @@ class DescribeSlideHelpers:
     def it_rejects_unknown_near_type_in_find_empty_region(self, slide):
         with pytest.raises(TypeError):
             slide.find_empty_region(near="not-a-shape")
+
+
+class DescribeCssHexShorthand:
+    def it_expands_three_digit_hex(self, slide):
+        rect = slide.shapes.add_shape(
+            MSO_SHAPE.RECTANGLE, Inches(0), Inches(0), Inches(2), Inches(1)
+        )
+        rect.fill_hex("#888")
+        assert str(rect.fill.fore_color.rgb) == "888888"