Add docs on color types

Co-Authored-By: Florentin Dörre <[email protected]>

Author: adamnsch

docs/source/customizing.rst

@@ -37,8 +37,18 @@ the first positional argument.
 By default the Neo4j color palette that works for both light and dark mode will be used.
 If you want to use a different color palette, you can pass a dictionary or iterable of colors as the ``colors``
 parameter.
-You can for example use the color palettes from the `palettable library <https://jiffyclub.github.io/palettable/>`_ as in
-the following example:
+A color value can for example be either strings like "blue", or hexadecimal color codes like "#FF0000", or even a tuple of RGB values like (255, 0, 255).
+Here is an example of providing a list of custom colors to the ``color_nodes`` method:
+
+.. code-block:: python
+
+    # VG is a VisualizationGraph object
+    VG.color_nodes("caption", ["red", "#7fffd4", (255, 255, 255, 0.5), "hsl(270, 60%, 70%)"])
+
+The full set of allowed values for colors are listed `here <https://docs.pydantic.dev/2.0/usage/types/extra_types/color_types/>`_.
+
+Instead of defining your own colors, you could also for example use the color palettes from the `palettable library <https://jiffyclub.github.io/palettable/>`_ as in
+this snippet:
 
 .. code-block:: python
 

python-wrapper/src/neo4j_viz/node.py

@@ -37,7 +37,7 @@ class Node(BaseModel, extra="allow"):
     )
     #: The size of the node as radius in pixel
     size: Optional[RealNumber] = Field(None, ge=0, description="The size of the node as radius in pixel")
-    #: The color of the node
+    #: The color of the node. Allowed input is for example "#FF0000", "red" or (255, 0, 0)
     color: Optional[ColorType] = Field(None, description="The color of the node")
     #: Whether the node is pinned in the visualization
     pinned: Optional[bool] = Field(None, description="Whether the node is pinned in the visualization")

python-wrapper/src/neo4j_viz/relationship.py

@@ -41,7 +41,7 @@ class Relationship(BaseModel, extra="allow"):
     caption_size: Optional[Union[int, float]] = Field(
         None, gt=0.0, serialization_alias="captionSize", description="The size of the caption text"
     )
-    #: The color of the relationship
+    #: The color of the relationship. Allowed input is for example "#FF0000", "red" or (255, 0, 0)
     color: Optional[ColorType] = Field(None, description="The color of the relationship")
 
     @field_serializer("color")

python-wrapper/src/neo4j_viz/visualization_graph.py

@@ -205,6 +205,7 @@ def color_nodes(self, property: str, colors: Optional[ColorsType] = None, overri
         colors:
             The colors to use for the nodes. If a dictionary is given, it should map from property to color.
             If an iterable is given, the colors are used in order.
+            Allowed color values are for example “#FF0000”, “red” or (255, 0, 0) (full list: https://docs.pydantic.dev/2.0/usage/types/extra_types/color_types/).
             The default colors are the Neo4j graph colors.
         override:
             Whether to override existing colors of the nodes, if they have any.