add property value for fill and color; set version to 1.0.3+PPTAgent

Author: Force1ess

src/pptx/__init__.py

@@ -25,7 +25,7 @@
 if TYPE_CHECKING:
     from pptx.opc.package import Part
 
-__version__ = "1.0.2+PPTAgent"
+__version__ = "1.0.3+PPTAgent"
 
 sys.modules["pptx.exceptions"] = exceptions
 del sys

src/pptx/dml/color.py

@@ -106,6 +106,16 @@ def _validate_brightness_value(self, value):
             )
             raise ValueError(msg)
 
+    @property
+    def value(self):
+        if self.type == MSO_COLOR_TYPE.RGB:
+            return str(self.rgb)
+        elif self.type == MSO_COLOR_TYPE.SCHEME:
+            return "ThemeColor-" + str(self.theme_color)
+        elif self.type is None:
+            return None
+        return str(self.type).split()[0]
+
 
 class _Color(object):
     """

src/pptx/dml/fill.py

@@ -160,6 +160,28 @@ def type(self) -> MSO_FILL_TYPE:
         """The type of this fill, e.g. `MSO_FILL_TYPE.SOLID`."""
         return self._fill.type
 
+    @property
+    def value(self):
+        """Return a value appropriate to the fill type.
+
+        For solid fills, returns the foreground color.
+        For pattern fills, returns the pattern type.
+        For gradient fills, returns the gradient stops.
+        For picture fills, returns "Picture".
+        For group fills, returns "Group".
+        For background (no fill), returns "Background".
+        Returns None if no fill is applied.
+        """
+        if self.type == MSO_FILL.SOLID:
+            return self.fore_color.value
+        elif self.type == MSO_FILL.PATTERNED or self.type == MSO_FILL.TEXTURED:
+            return "Texture"
+        elif self.type == MSO_FILL.GRADIENT:
+            return "GradientColor"
+        elif self.type == MSO_FILL.PICTURE:
+            return "Picture"
+        return None
+
 
 class _Fill(object):
     """

src/pptx/text/text.py

@@ -353,14 +353,9 @@ def bold(self, value: bool | None):
         self._rPr.b = value
 
     @lazyproperty
-    def color(self) -> ColorFormat:
+    def color(self) -> str|None:
         """The |ColorFormat| instance that provides access to the color settings for this font."""
-        if self.fill.type != MSO_FILL.SOLID:
-            self.fill.solid()
-        try:
-            return str(self.fill.fore_color.rgb)
-        except:
-            return None
+        return self.fill.value
 
     @lazyproperty
     def fill(self) -> FillFormat: