feat: use colors in gdocs

gdocs/managers/batch_operation_manager.py

@@ -170,7 +170,8 @@ class BatchOperationManager:
             request = create_format_text_request(
                 op['start_index'], op['end_index'],
                 op.get('bold'), op.get('italic'), op.get('underline'),
-                op.get('font_size'), op.get('font_family')
+                op.get('font_size'), op.get('font_family'),
+                op.get('text_color'), op.get('background_color')
             )
             
             if not request:
@@ -180,7 +181,8 @@ class BatchOperationManager:
             format_changes = []
             for param, name in [
                 ('bold', 'bold'), ('italic', 'italic'), ('underline', 'underline'),
-                ('font_size', 'font size'), ('font_family', 'font family')
+                ('font_size', 'font size'), ('font_family', 'font family'),
+                ('text_color', 'text color'), ('background_color', 'background color')
             ]:
                 if op.get(param) is not None:
                     value = f"{op[param]}pt" if param == 'font_size' else op[param]
@@ -278,7 +280,7 @@ class BatchOperationManager:
                 },
                 'format_text': {
                     'required': ['start_index', 'end_index'],
-                    'optional': ['bold', 'italic', 'underline', 'font_size', 'font_family'],
+                    'optional': ['bold', 'italic', 'underline', 'font_size', 'font_family', 'text_color', 'background_color'],
                     'description': 'Apply formatting to text range'
                 },
                 'insert_table': {
@@ -300,4 +302,4 @@ class BatchOperationManager:
                 {"type": "format_text", "start_index": 1, "end_index": 12, "bold": True},
                 {"type": "insert_table", "index": 20, "rows": 2, "columns": 3}
             ]
-        }
+        }

gdocs/managers/validation_manager.py

@@ -119,7 +119,9 @@ class ValidationManager:
         italic: Optional[bool] = None,
         underline: Optional[bool] = None,
         font_size: Optional[int] = None,
-        font_family: Optional[str] = None
+        font_family: Optional[str] = None,
+        text_color: Optional[Any] = None,
+        background_color: Optional[Any] = None
     ) -> Tuple[bool, str]:
         """
         Validate text formatting parameters.
@@ -130,14 +132,18 @@ class ValidationManager:
             underline: Underline setting
             font_size: Font size in points
             font_family: Font family name
+            text_color: Text color in hex or RGB tuple/list
+            background_color: Background color in hex or RGB tuple/list
             
         Returns:
             Tuple of (is_valid, error_message)
         """
         # Check if at least one formatting option is provided
-        formatting_params = [bold, italic, underline, font_size, font_family]
+        formatting_params = [
+            bold, italic, underline, font_size, font_family, text_color, background_color
+        ]
         if all(param is None for param in formatting_params):
-            return False, "At least one formatting parameter must be provided (bold, italic, underline, font_size, or font_family)"
+            return False, "At least one formatting parameter must be provided (bold, italic, underline, font_size, font_family, text_color, or background_color)"
         
         # Validate boolean parameters
         for param, name in [(bold, 'bold'), (italic, 'italic'), (underline, 'underline')]:
@@ -160,8 +166,53 @@ class ValidationManager:
             
             if not font_family.strip():
                 return False, "font_family cannot be empty"
+
+        # Validate colors
+        is_valid, error_msg = self.validate_color_param(text_color, "text_color")
+        if not is_valid:
+            return False, error_msg
+
+        is_valid, error_msg = self.validate_color_param(background_color, "background_color")
+        if not is_valid:
+            return False, error_msg
         
         return True, ""
+
+    def validate_color_param(self, color: Any, param_name: str) -> Tuple[bool, str]:
+        """
+        Validate color parameters (hex string or RGB tuple/list).
+        """
+        if color is None:
+            return True, ""
+
+        if isinstance(color, str):
+            hex_color = color.lstrip('#')
+            if len(hex_color) != 6 or any(c not in "0123456789abcdefABCDEF" for c in hex_color):
+                return False, f"{param_name} must be a hex string like '#RRGGBB' or 'RRGGBB'"
+            return True, ""
+
+        if isinstance(color, (list, tuple)):
+            if len(color) != 3:
+                return False, f"{param_name} tuple/list must have exactly 3 components"
+
+            for i, component in enumerate(color):
+                comp_name = f"{param_name}[{i}]"
+                if isinstance(component, bool):
+                    return False, f"{comp_name} cannot be a boolean"
+
+                if isinstance(component, int):
+                    if component < 0 or component > 255:
+                        return False, f"{comp_name} integer values must be between 0 and 255"
+                elif isinstance(component, (float, int)):
+                    component = float(component)
+                    if component < 0 or component > 1:
+                        return False, f"{comp_name} float values must be between 0 and 1"
+                else:
+                    return False, f"{comp_name} must be an int (0-255) or float (0-1), got {type(component).__name__}"
+
+            return True, ""
+
+        return False, f"{param_name} must be a hex string or RGB tuple/list like [255, 0, 0] or [1, 0, 0]"
     
     def validate_index(self, index: int, context: str = "Index") -> Tuple[bool, str]:
         """
@@ -377,4 +428,4 @@ class ValidationManager:
                 'text_formatting': "Optional boolean/integer parameters for styling",
                 'document_indices': "Non-negative integers for position specification"
             }
-        }
+        }