complete the API of plotly.colors and plotly.express.colors (#2510)

* complete the API of plotly.colors and plotly.express.colors

* blacken

* default colorscales

Author: emmanuelle

doc/apidoc/Makefile

@@ -22,13 +22,13 @@ help:
 	sed -i 's/:class:`plotly.graph_objects/:class:`plotly.graph_objs/g' ../../packages/python/plotly/plotly/graph_objs/*/*.py
 	sed -i 's/:class:`plotly.graph_objects/:class:`plotly.graph_objs/g' ../../packages/python/plotly/plotly/graph_objs/*/*/*.py
 	sed -i 's/:class:`plotly.graph_objects/:class:`plotly.graph_objs/g' ../../packages/python/plotly/plotly/graph_objs/*/*/*/*.py
-	cp ../../packages/python/plotly/_plotly_utils/colors/sequential.py ../../packages/python/plotly/_plotly_utils/colors/diverging.py ../../packages/python/plotly/_plotly_utils/colors/qualitative.py ../../packages/python/plotly/_plotly_utils/colors/cyclical.py ../../packages/python/plotly/plotly/colors
-	cp ../../packages/python/plotly/_plotly_utils/colors/sequential.py ../../packages/python/plotly/_plotly_utils/colors/diverging.py ../../packages/python/plotly/_plotly_utils/colors/qualitative.py ../../packages/python/plotly/_plotly_utils/colors/cyclical.py ../../packages/python/plotly/plotly/express/colors
+	cp ../../packages/python/plotly/_plotly_utils/colors/sequential.py ../../packages/python/plotly/_plotly_utils/colors/diverging.py ../../packages/python/plotly/_plotly_utils/colors/qualitative.py ../../packages/python/plotly/_plotly_utils/colors/cyclical.py ../../packages/python/plotly/_plotly_utils/colors/colorbrewer.py ../../packages/python/plotly/_plotly_utils/colors/carto.py ../../packages/python/plotly/_plotly_utils/colors/cmocean.py ../../packages/python/plotly/plotly/colors
+	cp ../../packages/python/plotly/_plotly_utils/colors/sequential.py ../../packages/python/plotly/_plotly_utils/colors/diverging.py ../../packages/python/plotly/_plotly_utils/colors/qualitative.py ../../packages/python/plotly/_plotly_utils/colors/cyclical.py ../../packages/python/plotly/_plotly_utils/colors/colorbrewer.py ../../packages/python/plotly/_plotly_utils/colors/carto.py ../../packages/python/plotly/_plotly_utils/colors/cmocean.py ../../packages/python/plotly/plotly/express/colors
 	sphinx-apidoc -M -o generated ../../packages/python/plotly/plotly ../../packages/python/plotly/plotly/validators ../../packages/python/plotly/plotly/tests ../../packages/python/plotly/plotly/matplotlylib/ ../../packages/python/plotly/plotly/offline ../../packages/python/plotly/plotly/api
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 	git checkout -- ../../packages/python/plotly/plotly/graph_objs
-	rm ../../packages/python/plotly/plotly/colors/diverging.py ../../packages/python/plotly/plotly/colors/sequential.py ../../packages/python/plotly/plotly/colors/qualitative.py ../../packages/python/plotly/plotly/colors/cyclical.py
-	rm ../../packages/python/plotly/plotly/express/colors/diverging.py ../../packages/python/plotly/plotly/express/colors/sequential.py ../../packages/python/plotly/plotly/express/colors/qualitative.py ../../packages/python/plotly/plotly/express/colors/cyclical.py
+	rm ../../packages/python/plotly/plotly/colors/diverging.py ../../packages/python/plotly/plotly/colors/sequential.py ../../packages/python/plotly/plotly/colors/qualitative.py ../../packages/python/plotly/plotly/colors/cyclical.py ../../packages/python/plotly/plotly/colors/colorbrewer.py ../../packages/python/plotly/plotly/colors/carto.py ../../packages/python/plotly/plotly/colors/cmocean.py
+	rm ../../packages/python/plotly/plotly/express/colors/diverging.py ../../packages/python/plotly/plotly/express/colors/sequential.py ../../packages/python/plotly/plotly/express/colors/qualitative.py ../../packages/python/plotly/plotly/express/colors/cyclical.py ../../packages/python/plotly/plotly/express/colors/colorbrewer.py ../../packages/python/plotly/plotly/express/colors/carto.py ../../packages/python/plotly/plotly/express/colors/cmocean.py
 	rename 's/graph_objs/graph_objects/' _build/html/*.html _build/html/generated/*.html
 	mv _build/html/generated/plotly.graph_objs.html _build/html/generated/plotly.graph_objects.html
 	sed -i 's/graph_objs/graph_objects/g' _build/html/*.html 

packages/python/plotly/plotly/colors/__init__.py

@@ -21,4 +21,28 @@
     "diverging",
     "sequential",
     "qualitative",
+    "colorbrewer",
+    "carto",
+    "cmocean",
+    "color_parser",
+    "colorscale_to_colors",
+    "colorscale_to_scale",
+    "convert_colors_to_same_type",
+    "convert_colorscale_to_rgb",
+    "convert_dict_colors_to_same_type",
+    "convert_to_RGB_255",
+    "find_intermediate_color",
+    "hex_to_rgb",
+    "label_rgb",
+    "make_colorscale",
+    "n_colors",
+    "unconvert_from_RGB_255",
+    "unlabel_rgb",
+    "validate_colors",
+    "validate_colors_dict",
+    "validate_colorscale",
+    "validate_scale_values",
+    "plotlyjs",
+    "DEFAULT_PLOTLY_COLORS",
+    "PLOTLY_SCALES",
 ]

packages/python/plotly/plotly/express/colors/__init__.py

@@ -22,4 +22,29 @@
     "diverging",
     "sequential",
     "qualitative",
+    "colorbrewer",
+    "colorbrewer",
+    "carto",
+    "cmocean",
+    "color_parser",
+    "colorscale_to_colors",
+    "colorscale_to_scale",
+    "convert_colors_to_same_type",
+    "convert_colorscale_to_rgb",
+    "convert_dict_colors_to_same_type",
+    "convert_to_RGB_255",
+    "find_intermediate_color",
+    "hex_to_rgb",
+    "label_rgb",
+    "make_colorscale",
+    "n_colors",
+    "unconvert_from_RGB_255",
+    "unlabel_rgb",
+    "validate_colors",
+    "validate_colors_dict",
+    "validate_colorscale",
+    "validate_scale_values",
+    "plotlyjs",
+    "DEFAULT_PLOTLY_COLORS",
+    "PLOTLY_SCALES",
 ]