Add (color, alpha) tuple as a valid ColorType

ksunden · ksunden · commit dd982079455f · 2023-03-31T20:07:31.000-05:00
Introduced by #24691, merged shortly before #24976 Not totally sold on the name 'RawColorType', but couldn't think of something I like better Noticed that one of the other type aliases was not documented, so fixed that while I was editing these two files
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -17,6 +17,7 @@ repos:
     hooks:
       - id: check-added-large-files
       - id: check-docstring-first
+        exclude: lib/matplotlib/typing.py  # docstring used for attribute flagged by check
       - id: end-of-file-fixer
         exclude_types: [svg]
       - id: mixed-line-ending
diff --git a/doc/api/typing_api.rst b/doc/api/typing_api.rst
@@ -2,10 +2,14 @@
 ``matplotlib.typing``
 *********************
 
+.. autodata:: matplotlib.typing.RawColorType
+.. autodata:: matplotlib.typing.RawColourType
 .. autodata:: matplotlib.typing.ColorType
 .. autodata:: matplotlib.typing.ColourType
 .. autodata:: matplotlib.typing.LineStyleType
 .. autodata:: matplotlib.typing.DrawStyleType
 .. autodata:: matplotlib.typing.MarkEveryType
 .. autodata:: matplotlib.typing.FillStyleType
 .. autodata:: matplotlib.typing.RcStyleType
+.. autodata:: matplotlib.typing.HashableList
+   :annotation: Nested list with Hashable values
diff --git a/lib/matplotlib/typing.py b/lib/matplotlib/typing.py
@@ -19,7 +19,10 @@
 # The following are type aliases. Once python 3.9 is dropped, they should be annotated
 # using ``typing.TypeAlias`` and Unions should be converted to using ``|`` syntax.
 
-ColorType = Union[tuple[float, float, float], tuple[float, float, float, float], str]
+RawColorType = Union[tuple[float, float, float], tuple[float, float, float, float], str]
+RawColourType = RawColorType
+
+ColorType = Union[RawColorType, tuple[RawColorType, float]]
 ColourType = ColorType
 
 LineStyleType = Union[str, tuple[float, Sequence[float]]]
@@ -43,3 +46,4 @@
 ]
 
 HashableList = list[Union[Hashable, "HashableList"]]
+"""A nested list of Hashable values."""
