first commit

.venv/Lib/site-packages/plotly/graph_objs/sankey/__init__.py

@@ -0,0 +1,31 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._domain import Domain
+    from ._hoverlabel import Hoverlabel
+    from ._legendgrouptitle import Legendgrouptitle
+    from ._link import Link
+    from ._node import Node
+    from ._stream import Stream
+    from ._textfont import Textfont
+    from . import hoverlabel
+    from . import legendgrouptitle
+    from . import link
+    from . import node
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(
+        __name__,
+        [".hoverlabel", ".legendgrouptitle", ".link", ".node"],
+        [
+            "._domain.Domain",
+            "._hoverlabel.Hoverlabel",
+            "._legendgrouptitle.Legendgrouptitle",
+            "._link.Link",
+            "._node.Node",
+            "._stream.Stream",
+            "._textfont.Textfont",
+        ],
+    )

.venv/Lib/site-packages/plotly/graph_objs/sankey/_domain.py

@@ -0,0 +1,206 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Domain(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey"
+    _path_str = "sankey.domain"
+    _valid_props = {"column", "row", "x", "y"}
+
+    # column
+    # ------
+    @property
+    def column(self):
+        """
+        If there is a layout grid, use the domain for this column in
+        the grid for this sankey trace .
+
+        The 'column' property is a integer and may be specified as:
+          - An int (or float that will be cast to an int)
+            in the interval [0, 9223372036854775807]
+
+        Returns
+        -------
+        int
+        """
+        return self["column"]
+
+    @column.setter
+    def column(self, val):
+        self["column"] = val
+
+    # row
+    # ---
+    @property
+    def row(self):
+        """
+        If there is a layout grid, use the domain for this row in the
+        grid for this sankey trace .
+
+        The 'row' property is a integer and may be specified as:
+          - An int (or float that will be cast to an int)
+            in the interval [0, 9223372036854775807]
+
+        Returns
+        -------
+        int
+        """
+        return self["row"]
+
+    @row.setter
+    def row(self, val):
+        self["row"] = val
+
+    # x
+    # -
+    @property
+    def x(self):
+        """
+            Sets the horizontal domain of this sankey trace (in plot
+            fraction).
+
+            The 'x' property is an info array that may be specified as:
+
+            * a list or tuple of 2 elements where:
+        (0) The 'x[0]' property is a number and may be specified as:
+              - An int or float in the interval [0, 1]
+        (1) The 'x[1]' property is a number and may be specified as:
+              - An int or float in the interval [0, 1]
+
+            Returns
+            -------
+            list
+        """
+        return self["x"]
+
+    @x.setter
+    def x(self, val):
+        self["x"] = val
+
+    # y
+    # -
+    @property
+    def y(self):
+        """
+            Sets the vertical domain of this sankey trace (in plot
+            fraction).
+
+            The 'y' property is an info array that may be specified as:
+
+            * a list or tuple of 2 elements where:
+        (0) The 'y[0]' property is a number and may be specified as:
+              - An int or float in the interval [0, 1]
+        (1) The 'y[1]' property is a number and may be specified as:
+              - An int or float in the interval [0, 1]
+
+            Returns
+            -------
+            list
+        """
+        return self["y"]
+
+    @y.setter
+    def y(self, val):
+        self["y"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        column
+            If there is a layout grid, use the domain for this
+            column in the grid for this sankey trace .
+        row
+            If there is a layout grid, use the domain for this row
+            in the grid for this sankey trace .
+        x
+            Sets the horizontal domain of this sankey trace (in
+            plot fraction).
+        y
+            Sets the vertical domain of this sankey trace (in plot
+            fraction).
+        """
+
+    def __init__(self, arg=None, column=None, row=None, x=None, y=None, **kwargs):
+        """
+        Construct a new Domain object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of :class:`plotly.graph_objs.sankey.Domain`
+        column
+            If there is a layout grid, use the domain for this
+            column in the grid for this sankey trace .
+        row
+            If there is a layout grid, use the domain for this row
+            in the grid for this sankey trace .
+        x
+            Sets the horizontal domain of this sankey trace (in
+            plot fraction).
+        y
+            Sets the vertical domain of this sankey trace (in plot
+            fraction).
+
+        Returns
+        -------
+        Domain
+        """
+        super(Domain, self).__init__("domain")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.Domain
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.Domain`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("column", None)
+        _v = column if column is not None else _v
+        if _v is not None:
+            self["column"] = _v
+        _v = arg.pop("row", None)
+        _v = row if row is not None else _v
+        if _v is not None:
+            self["row"] = _v
+        _v = arg.pop("x", None)
+        _v = x if x is not None else _v
+        if _v is not None:
+            self["x"] = _v
+        _v = arg.pop("y", None)
+        _v = y if y is not None else _v
+        if _v is not None:
+            self["y"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/_hoverlabel.py

@@ -0,0 +1,503 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Hoverlabel(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey"
+    _path_str = "sankey.hoverlabel"
+    _valid_props = {
+        "align",
+        "alignsrc",
+        "bgcolor",
+        "bgcolorsrc",
+        "bordercolor",
+        "bordercolorsrc",
+        "font",
+        "namelength",
+        "namelengthsrc",
+    }
+
+    # align
+    # -----
+    @property
+    def align(self):
+        """
+        Sets the horizontal alignment of the text content within hover
+        label box. Has an effect only if the hover label text spans
+        more two or more lines
+
+        The 'align' property is an enumeration that may be specified as:
+          - One of the following enumeration values:
+                ['left', 'right', 'auto']
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        Any|numpy.ndarray
+        """
+        return self["align"]
+
+    @align.setter
+    def align(self, val):
+        self["align"] = val
+
+    # alignsrc
+    # --------
+    @property
+    def alignsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `align`.
+
+        The 'alignsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["alignsrc"]
+
+    @alignsrc.setter
+    def alignsrc(self, val):
+        self["alignsrc"] = val
+
+    # bgcolor
+    # -------
+    @property
+    def bgcolor(self):
+        """
+        Sets the background color of the hover labels for this trace
+
+        The 'bgcolor' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["bgcolor"]
+
+    @bgcolor.setter
+    def bgcolor(self, val):
+        self["bgcolor"] = val
+
+    # bgcolorsrc
+    # ----------
+    @property
+    def bgcolorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `bgcolor`.
+
+        The 'bgcolorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["bgcolorsrc"]
+
+    @bgcolorsrc.setter
+    def bgcolorsrc(self, val):
+        self["bgcolorsrc"] = val
+
+    # bordercolor
+    # -----------
+    @property
+    def bordercolor(self):
+        """
+        Sets the border color of the hover labels for this trace.
+
+        The 'bordercolor' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["bordercolor"]
+
+    @bordercolor.setter
+    def bordercolor(self, val):
+        self["bordercolor"] = val
+
+    # bordercolorsrc
+    # --------------
+    @property
+    def bordercolorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `bordercolor`.
+
+        The 'bordercolorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["bordercolorsrc"]
+
+    @bordercolorsrc.setter
+    def bordercolorsrc(self, val):
+        self["bordercolorsrc"] = val
+
+    # font
+    # ----
+    @property
+    def font(self):
+        """
+        Sets the font used in hover labels.
+
+        The 'font' property is an instance of Font
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.sankey.hoverlabel.Font`
+          - A dict of string/value properties that will be passed
+            to the Font constructor
+
+            Supported dict properties:
+
+                color
+
+                colorsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `color`.
+                family
+                    HTML font family - the typeface that will be
+                    applied by the web browser. The web browser
+                    will only be able to apply a font if it is
+                    available on the system which it operates.
+                    Provide multiple font families, separated by
+                    commas, to indicate the preference in which to
+                    apply fonts if they aren't available on the
+                    system. The Chart Studio Cloud (at
+                    https://chart-studio.plotly.com or on-premise)
+                    generates images on a server, where only a
+                    select number of fonts are installed and
+                    supported. These include "Arial", "Balto",
+                    "Courier New", "Droid Sans",, "Droid Serif",
+                    "Droid Sans Mono", "Gravitas One", "Old
+                    Standard TT", "Open Sans", "Overpass", "PT Sans
+                    Narrow", "Raleway", "Times New Roman".
+                familysrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `family`.
+                size
+
+                sizesrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `size`.
+
+        Returns
+        -------
+        plotly.graph_objs.sankey.hoverlabel.Font
+        """
+        return self["font"]
+
+    @font.setter
+    def font(self, val):
+        self["font"] = val
+
+    # namelength
+    # ----------
+    @property
+    def namelength(self):
+        """
+        Sets the default length (in number of characters) of the trace
+        name in the hover labels for all traces. -1 shows the whole
+        name regardless of length. 0-3 shows the first 0-3 characters,
+        and an integer >3 will show the whole name if it is less than
+        that many characters, but if it is longer, will truncate to
+        `namelength - 3` characters and add an ellipsis.
+
+        The 'namelength' property is a integer and may be specified as:
+          - An int (or float that will be cast to an int)
+            in the interval [-1, 9223372036854775807]
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        int|numpy.ndarray
+        """
+        return self["namelength"]
+
+    @namelength.setter
+    def namelength(self, val):
+        self["namelength"] = val
+
+    # namelengthsrc
+    # -------------
+    @property
+    def namelengthsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `namelength`.
+
+        The 'namelengthsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["namelengthsrc"]
+
+    @namelengthsrc.setter
+    def namelengthsrc(self, val):
+        self["namelengthsrc"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        align
+            Sets the horizontal alignment of the text content
+            within hover label box. Has an effect only if the hover
+            label text spans more two or more lines
+        alignsrc
+            Sets the source reference on Chart Studio Cloud for
+            `align`.
+        bgcolor
+            Sets the background color of the hover labels for this
+            trace
+        bgcolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bgcolor`.
+        bordercolor
+            Sets the border color of the hover labels for this
+            trace.
+        bordercolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bordercolor`.
+        font
+            Sets the font used in hover labels.
+        namelength
+            Sets the default length (in number of characters) of
+            the trace name in the hover labels for all traces. -1
+            shows the whole name regardless of length. 0-3 shows
+            the first 0-3 characters, and an integer >3 will show
+            the whole name if it is less than that many characters,
+            but if it is longer, will truncate to `namelength - 3`
+            characters and add an ellipsis.
+        namelengthsrc
+            Sets the source reference on Chart Studio Cloud for
+            `namelength`.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        align=None,
+        alignsrc=None,
+        bgcolor=None,
+        bgcolorsrc=None,
+        bordercolor=None,
+        bordercolorsrc=None,
+        font=None,
+        namelength=None,
+        namelengthsrc=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Hoverlabel object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.sankey.Hoverlabel`
+        align
+            Sets the horizontal alignment of the text content
+            within hover label box. Has an effect only if the hover
+            label text spans more two or more lines
+        alignsrc
+            Sets the source reference on Chart Studio Cloud for
+            `align`.
+        bgcolor
+            Sets the background color of the hover labels for this
+            trace
+        bgcolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bgcolor`.
+        bordercolor
+            Sets the border color of the hover labels for this
+            trace.
+        bordercolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bordercolor`.
+        font
+            Sets the font used in hover labels.
+        namelength
+            Sets the default length (in number of characters) of
+            the trace name in the hover labels for all traces. -1
+            shows the whole name regardless of length. 0-3 shows
+            the first 0-3 characters, and an integer >3 will show
+            the whole name if it is less than that many characters,
+            but if it is longer, will truncate to `namelength - 3`
+            characters and add an ellipsis.
+        namelengthsrc
+            Sets the source reference on Chart Studio Cloud for
+            `namelength`.
+
+        Returns
+        -------
+        Hoverlabel
+        """
+        super(Hoverlabel, self).__init__("hoverlabel")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.Hoverlabel
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.Hoverlabel`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("align", None)
+        _v = align if align is not None else _v
+        if _v is not None:
+            self["align"] = _v
+        _v = arg.pop("alignsrc", None)
+        _v = alignsrc if alignsrc is not None else _v
+        if _v is not None:
+            self["alignsrc"] = _v
+        _v = arg.pop("bgcolor", None)
+        _v = bgcolor if bgcolor is not None else _v
+        if _v is not None:
+            self["bgcolor"] = _v
+        _v = arg.pop("bgcolorsrc", None)
+        _v = bgcolorsrc if bgcolorsrc is not None else _v
+        if _v is not None:
+            self["bgcolorsrc"] = _v
+        _v = arg.pop("bordercolor", None)
+        _v = bordercolor if bordercolor is not None else _v
+        if _v is not None:
+            self["bordercolor"] = _v
+        _v = arg.pop("bordercolorsrc", None)
+        _v = bordercolorsrc if bordercolorsrc is not None else _v
+        if _v is not None:
+            self["bordercolorsrc"] = _v
+        _v = arg.pop("font", None)
+        _v = font if font is not None else _v
+        if _v is not None:
+            self["font"] = _v
+        _v = arg.pop("namelength", None)
+        _v = namelength if namelength is not None else _v
+        if _v is not None:
+            self["namelength"] = _v
+        _v = arg.pop("namelengthsrc", None)
+        _v = namelengthsrc if namelengthsrc is not None else _v
+        if _v is not None:
+            self["namelengthsrc"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/_legendgrouptitle.py

@@ -0,0 +1,154 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Legendgrouptitle(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey"
+    _path_str = "sankey.legendgrouptitle"
+    _valid_props = {"font", "text"}
+
+    # font
+    # ----
+    @property
+    def font(self):
+        """
+        Sets this legend group's title font.
+
+        The 'font' property is an instance of Font
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.sankey.legendgrouptitle.Font`
+          - A dict of string/value properties that will be passed
+            to the Font constructor
+
+            Supported dict properties:
+
+                color
+
+                family
+                    HTML font family - the typeface that will be
+                    applied by the web browser. The web browser
+                    will only be able to apply a font if it is
+                    available on the system which it operates.
+                    Provide multiple font families, separated by
+                    commas, to indicate the preference in which to
+                    apply fonts if they aren't available on the
+                    system. The Chart Studio Cloud (at
+                    https://chart-studio.plotly.com or on-premise)
+                    generates images on a server, where only a
+                    select number of fonts are installed and
+                    supported. These include "Arial", "Balto",
+                    "Courier New", "Droid Sans",, "Droid Serif",
+                    "Droid Sans Mono", "Gravitas One", "Old
+                    Standard TT", "Open Sans", "Overpass", "PT Sans
+                    Narrow", "Raleway", "Times New Roman".
+                size
+
+        Returns
+        -------
+        plotly.graph_objs.sankey.legendgrouptitle.Font
+        """
+        return self["font"]
+
+    @font.setter
+    def font(self, val):
+        self["font"] = val
+
+    # text
+    # ----
+    @property
+    def text(self):
+        """
+        Sets the title of the legend group.
+
+        The 'text' property is a string and must be specified as:
+          - A string
+          - A number that will be converted to a string
+
+        Returns
+        -------
+        str
+        """
+        return self["text"]
+
+    @text.setter
+    def text(self, val):
+        self["text"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        font
+            Sets this legend group's title font.
+        text
+            Sets the title of the legend group.
+        """
+
+    def __init__(self, arg=None, font=None, text=None, **kwargs):
+        """
+        Construct a new Legendgrouptitle object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.sankey.Legendgrouptitle`
+        font
+            Sets this legend group's title font.
+        text
+            Sets the title of the legend group.
+
+        Returns
+        -------
+        Legendgrouptitle
+        """
+        super(Legendgrouptitle, self).__init__("legendgrouptitle")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.Legendgrouptitle
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.Legendgrouptitle`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("font", None)
+        _v = font if font is not None else _v
+        if _v is not None:
+            self["font"] = _v
+        _v = arg.pop("text", None)
+        _v = text if text is not None else _v
+        if _v is not None:
+            self["text"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/_link.py

@@ -0,0 +1,929 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Link(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey"
+    _path_str = "sankey.link"
+    _valid_props = {
+        "color",
+        "colorscaledefaults",
+        "colorscales",
+        "colorsrc",
+        "customdata",
+        "customdatasrc",
+        "hoverinfo",
+        "hoverlabel",
+        "hovertemplate",
+        "hovertemplatesrc",
+        "label",
+        "labelsrc",
+        "line",
+        "source",
+        "sourcesrc",
+        "target",
+        "targetsrc",
+        "value",
+        "valuesrc",
+    }
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        Sets the `link` color. It can be a single value, or an array
+        for specifying color for each `link`. If `link.color` is
+        omitted, then by default, a translucent grey link will be used.
+
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # colorscales
+    # -----------
+    @property
+    def colorscales(self):
+        """
+        The 'colorscales' property is a tuple of instances of
+        Colorscale that may be specified as:
+          - A list or tuple of instances of plotly.graph_objs.sankey.link.Colorscale
+          - A list or tuple of dicts of string/value properties that
+            will be passed to the Colorscale constructor
+
+            Supported dict properties:
+
+                cmax
+                    Sets the upper bound of the color domain.
+                cmin
+                    Sets the lower bound of the color domain.
+                colorscale
+                    Sets the colorscale. The colorscale must be an
+                    array containing arrays mapping a normalized
+                    value to an rgb, rgba, hex, hsl, hsv, or named
+                    color string. At minimum, a mapping for the
+                    lowest (0) and highest (1) values are required.
+                    For example, `[[0, 'rgb(0,0,255)'], [1,
+                    'rgb(255,0,0)']]`. To control the bounds of the
+                    colorscale in color space, use `cmin` and
+                    `cmax`. Alternatively, `colorscale` may be a
+                    palette name string of the following list: Blac
+                    kbody,Bluered,Blues,Cividis,Earth,Electric,Gree
+                    ns,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,R
+                    eds,Viridis,YlGnBu,YlOrRd.
+                label
+                    The label of the links to color based on their
+                    concentration within a flow.
+                name
+                    When used in a template, named items are
+                    created in the output figure in addition to any
+                    items the figure already has in this array. You
+                    can modify these items in the output figure by
+                    making your own item with `templateitemname`
+                    matching this `name` alongside your
+                    modifications (including `visible: false` or
+                    `enabled: false` to hide it). Has no effect
+                    outside of a template.
+                templateitemname
+                    Used to refer to a named item in this array in
+                    the template. Named items from the template
+                    will be created even without a matching item in
+                    the input figure, but you can modify one by
+                    making an item with `templateitemname` matching
+                    its `name`, alongside your modifications
+                    (including `visible: false` or `enabled: false`
+                    to hide it). If there is no template or no
+                    matching item, this item will be hidden unless
+                    you explicitly show it with `visible: true`.
+
+        Returns
+        -------
+        tuple[plotly.graph_objs.sankey.link.Colorscale]
+        """
+        return self["colorscales"]
+
+    @colorscales.setter
+    def colorscales(self, val):
+        self["colorscales"] = val
+
+    # colorscaledefaults
+    # ------------------
+    @property
+    def colorscaledefaults(self):
+        """
+        When used in a template (as
+        layout.template.data.sankey.link.colorscaledefaults), sets the
+        default property values to use for elements of
+        sankey.link.colorscales
+
+        The 'colorscaledefaults' property is an instance of Colorscale
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.sankey.link.Colorscale`
+          - A dict of string/value properties that will be passed
+            to the Colorscale constructor
+
+            Supported dict properties:
+
+        Returns
+        -------
+        plotly.graph_objs.sankey.link.Colorscale
+        """
+        return self["colorscaledefaults"]
+
+    @colorscaledefaults.setter
+    def colorscaledefaults(self, val):
+        self["colorscaledefaults"] = val
+
+    # colorsrc
+    # --------
+    @property
+    def colorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `color`.
+
+        The 'colorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["colorsrc"]
+
+    @colorsrc.setter
+    def colorsrc(self, val):
+        self["colorsrc"] = val
+
+    # customdata
+    # ----------
+    @property
+    def customdata(self):
+        """
+        Assigns extra data to each link.
+
+        The 'customdata' property is an array that may be specified as a tuple,
+        list, numpy array, or pandas Series
+
+        Returns
+        -------
+        numpy.ndarray
+        """
+        return self["customdata"]
+
+    @customdata.setter
+    def customdata(self, val):
+        self["customdata"] = val
+
+    # customdatasrc
+    # -------------
+    @property
+    def customdatasrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `customdata`.
+
+        The 'customdatasrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["customdatasrc"]
+
+    @customdatasrc.setter
+    def customdatasrc(self, val):
+        self["customdatasrc"] = val
+
+    # hoverinfo
+    # ---------
+    @property
+    def hoverinfo(self):
+        """
+        Determines which trace information appear when hovering links.
+        If `none` or `skip` are set, no information is displayed upon
+        hovering. But, if `none` is set, click and hover events are
+        still fired.
+
+        The 'hoverinfo' property is an enumeration that may be specified as:
+          - One of the following enumeration values:
+                ['all', 'none', 'skip']
+
+        Returns
+        -------
+        Any
+        """
+        return self["hoverinfo"]
+
+    @hoverinfo.setter
+    def hoverinfo(self, val):
+        self["hoverinfo"] = val
+
+    # hoverlabel
+    # ----------
+    @property
+    def hoverlabel(self):
+        """
+        The 'hoverlabel' property is an instance of Hoverlabel
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.sankey.link.Hoverlabel`
+          - A dict of string/value properties that will be passed
+            to the Hoverlabel constructor
+
+            Supported dict properties:
+
+                align
+                    Sets the horizontal alignment of the text
+                    content within hover label box. Has an effect
+                    only if the hover label text spans more two or
+                    more lines
+                alignsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `align`.
+                bgcolor
+                    Sets the background color of the hover labels
+                    for this trace
+                bgcolorsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `bgcolor`.
+                bordercolor
+                    Sets the border color of the hover labels for
+                    this trace.
+                bordercolorsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `bordercolor`.
+                font
+                    Sets the font used in hover labels.
+                namelength
+                    Sets the default length (in number of
+                    characters) of the trace name in the hover
+                    labels for all traces. -1 shows the whole name
+                    regardless of length. 0-3 shows the first 0-3
+                    characters, and an integer >3 will show the
+                    whole name if it is less than that many
+                    characters, but if it is longer, will truncate
+                    to `namelength - 3` characters and add an
+                    ellipsis.
+                namelengthsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `namelength`.
+
+        Returns
+        -------
+        plotly.graph_objs.sankey.link.Hoverlabel
+        """
+        return self["hoverlabel"]
+
+    @hoverlabel.setter
+    def hoverlabel(self, val):
+        self["hoverlabel"] = val
+
+    # hovertemplate
+    # -------------
+    @property
+    def hovertemplate(self):
+        """
+        Template string used for rendering the information that appear
+        on hover box. Note that this will override `hoverinfo`.
+        Variables are inserted using %{variable}, for example "y: %{y}"
+        as well as %{xother}, {%_xother}, {%_xother_}, {%xother_}. When
+        showing info for several points, "xother" will be added to
+        those with different x positions from the first point. An
+        underscore before or after "(x|y)other" will add a space on
+        that side, only when this field is shown. Numbers are formatted
+        using d3-format's syntax %{variable:d3-format}, for example
+        "Price: %{y:$.2f}".
+        https://github.com/d3/d3-format/tree/v1.4.5#d3-format for
+        details on the formatting syntax. Dates are formatted using
+        d3-time-format's syntax %{variable|d3-time-format}, for example
+        "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-
+        format/tree/v2.2.3#locale_format for details on the date
+        formatting syntax. The variables available in `hovertemplate`
+        are the ones emitted as event data described at this link
+        https://plotly.com/javascript/plotlyjs-events/#event-data.
+        Additionally, every attributes that can be specified per-point
+        (the ones that are `arrayOk: true`) are available. variables
+        `value` and `label`. Anything contained in tag `<extra>` is
+        displayed in the secondary box, for example
+        "<extra>{fullData.name}</extra>". To hide the secondary box
+        completely, use an empty tag `<extra></extra>`.
+
+        The 'hovertemplate' property is a string and must be specified as:
+          - A string
+          - A number that will be converted to a string
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["hovertemplate"]
+
+    @hovertemplate.setter
+    def hovertemplate(self, val):
+        self["hovertemplate"] = val
+
+    # hovertemplatesrc
+    # ----------------
+    @property
+    def hovertemplatesrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `hovertemplate`.
+
+        The 'hovertemplatesrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["hovertemplatesrc"]
+
+    @hovertemplatesrc.setter
+    def hovertemplatesrc(self, val):
+        self["hovertemplatesrc"] = val
+
+    # label
+    # -----
+    @property
+    def label(self):
+        """
+        The shown name of the link.
+
+        The 'label' property is an array that may be specified as a tuple,
+        list, numpy array, or pandas Series
+
+        Returns
+        -------
+        numpy.ndarray
+        """
+        return self["label"]
+
+    @label.setter
+    def label(self, val):
+        self["label"] = val
+
+    # labelsrc
+    # --------
+    @property
+    def labelsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `label`.
+
+        The 'labelsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["labelsrc"]
+
+    @labelsrc.setter
+    def labelsrc(self, val):
+        self["labelsrc"] = val
+
+    # line
+    # ----
+    @property
+    def line(self):
+        """
+        The 'line' property is an instance of Line
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.sankey.link.Line`
+          - A dict of string/value properties that will be passed
+            to the Line constructor
+
+            Supported dict properties:
+
+                color
+                    Sets the color of the `line` around each
+                    `link`.
+                colorsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `color`.
+                width
+                    Sets the width (in px) of the `line` around
+                    each `link`.
+                widthsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `width`.
+
+        Returns
+        -------
+        plotly.graph_objs.sankey.link.Line
+        """
+        return self["line"]
+
+    @line.setter
+    def line(self, val):
+        self["line"] = val
+
+    # source
+    # ------
+    @property
+    def source(self):
+        """
+        An integer number `[0..nodes.length - 1]` that represents the
+        source node.
+
+        The 'source' property is an array that may be specified as a tuple,
+        list, numpy array, or pandas Series
+
+        Returns
+        -------
+        numpy.ndarray
+        """
+        return self["source"]
+
+    @source.setter
+    def source(self, val):
+        self["source"] = val
+
+    # sourcesrc
+    # ---------
+    @property
+    def sourcesrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `source`.
+
+        The 'sourcesrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["sourcesrc"]
+
+    @sourcesrc.setter
+    def sourcesrc(self, val):
+        self["sourcesrc"] = val
+
+    # target
+    # ------
+    @property
+    def target(self):
+        """
+        An integer number `[0..nodes.length - 1]` that represents the
+        target node.
+
+        The 'target' property is an array that may be specified as a tuple,
+        list, numpy array, or pandas Series
+
+        Returns
+        -------
+        numpy.ndarray
+        """
+        return self["target"]
+
+    @target.setter
+    def target(self, val):
+        self["target"] = val
+
+    # targetsrc
+    # ---------
+    @property
+    def targetsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `target`.
+
+        The 'targetsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["targetsrc"]
+
+    @targetsrc.setter
+    def targetsrc(self, val):
+        self["targetsrc"] = val
+
+    # value
+    # -----
+    @property
+    def value(self):
+        """
+        A numeric value representing the flow volume value.
+
+        The 'value' property is an array that may be specified as a tuple,
+        list, numpy array, or pandas Series
+
+        Returns
+        -------
+        numpy.ndarray
+        """
+        return self["value"]
+
+    @value.setter
+    def value(self, val):
+        self["value"] = val
+
+    # valuesrc
+    # --------
+    @property
+    def valuesrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `value`.
+
+        The 'valuesrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["valuesrc"]
+
+    @valuesrc.setter
+    def valuesrc(self, val):
+        self["valuesrc"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+            Sets the `link` color. It can be a single value, or an
+            array for specifying color for each `link`. If
+            `link.color` is omitted, then by default, a translucent
+            grey link will be used.
+        colorscales
+            A tuple of
+            :class:`plotly.graph_objects.sankey.link.Colorscale`
+            instances or dicts with compatible properties
+        colorscaledefaults
+            When used in a template (as
+            layout.template.data.sankey.link.colorscaledefaults),
+            sets the default property values to use for elements of
+            sankey.link.colorscales
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        customdata
+            Assigns extra data to each link.
+        customdatasrc
+            Sets the source reference on Chart Studio Cloud for
+            `customdata`.
+        hoverinfo
+            Determines which trace information appear when hovering
+            links. If `none` or `skip` are set, no information is
+            displayed upon hovering. But, if `none` is set, click
+            and hover events are still fired.
+        hoverlabel
+            :class:`plotly.graph_objects.sankey.link.Hoverlabel`
+            instance or dict with compatible properties
+        hovertemplate
+            Template string used for rendering the information that
+            appear on hover box. Note that this will override
+            `hoverinfo`. Variables are inserted using %{variable},
+            for example "y: %{y}" as well as %{xother}, {%_xother},
+            {%_xother_}, {%xother_}. When showing info for several
+            points, "xother" will be added to those with different
+            x positions from the first point. An underscore before
+            or after "(x|y)other" will add a space on that side,
+            only when this field is shown. Numbers are formatted
+            using d3-format's syntax %{variable:d3-format}, for
+            example "Price: %{y:$.2f}".
+            https://github.com/d3/d3-format/tree/v1.4.5#d3-format
+            for details on the formatting syntax. Dates are
+            formatted using d3-time-format's syntax
+            %{variable|d3-time-format}, for example "Day:
+            %{2019-01-01|%A}". https://github.com/d3/d3-time-
+            format/tree/v2.2.3#locale_format for details on the
+            date formatting syntax. The variables available in
+            `hovertemplate` are the ones emitted as event data
+            described at this link
+            https://plotly.com/javascript/plotlyjs-events/#event-
+            data. Additionally, every attributes that can be
+            specified per-point (the ones that are `arrayOk: true`)
+            are available. variables `value` and `label`. Anything
+            contained in tag `<extra>` is displayed in the
+            secondary box, for example
+            "<extra>{fullData.name}</extra>". To hide the secondary
+            box completely, use an empty tag `<extra></extra>`.
+        hovertemplatesrc
+            Sets the source reference on Chart Studio Cloud for
+            `hovertemplate`.
+        label
+            The shown name of the link.
+        labelsrc
+            Sets the source reference on Chart Studio Cloud for
+            `label`.
+        line
+            :class:`plotly.graph_objects.sankey.link.Line` instance
+            or dict with compatible properties
+        source
+            An integer number `[0..nodes.length - 1]` that
+            represents the source node.
+        sourcesrc
+            Sets the source reference on Chart Studio Cloud for
+            `source`.
+        target
+            An integer number `[0..nodes.length - 1]` that
+            represents the target node.
+        targetsrc
+            Sets the source reference on Chart Studio Cloud for
+            `target`.
+        value
+            A numeric value representing the flow volume value.
+        valuesrc
+            Sets the source reference on Chart Studio Cloud for
+            `value`.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        color=None,
+        colorscales=None,
+        colorscaledefaults=None,
+        colorsrc=None,
+        customdata=None,
+        customdatasrc=None,
+        hoverinfo=None,
+        hoverlabel=None,
+        hovertemplate=None,
+        hovertemplatesrc=None,
+        label=None,
+        labelsrc=None,
+        line=None,
+        source=None,
+        sourcesrc=None,
+        target=None,
+        targetsrc=None,
+        value=None,
+        valuesrc=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Link object
+
+        The links of the Sankey plot.
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of :class:`plotly.graph_objs.sankey.Link`
+        color
+            Sets the `link` color. It can be a single value, or an
+            array for specifying color for each `link`. If
+            `link.color` is omitted, then by default, a translucent
+            grey link will be used.
+        colorscales
+            A tuple of
+            :class:`plotly.graph_objects.sankey.link.Colorscale`
+            instances or dicts with compatible properties
+        colorscaledefaults
+            When used in a template (as
+            layout.template.data.sankey.link.colorscaledefaults),
+            sets the default property values to use for elements of
+            sankey.link.colorscales
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        customdata
+            Assigns extra data to each link.
+        customdatasrc
+            Sets the source reference on Chart Studio Cloud for
+            `customdata`.
+        hoverinfo
+            Determines which trace information appear when hovering
+            links. If `none` or `skip` are set, no information is
+            displayed upon hovering. But, if `none` is set, click
+            and hover events are still fired.
+        hoverlabel
+            :class:`plotly.graph_objects.sankey.link.Hoverlabel`
+            instance or dict with compatible properties
+        hovertemplate
+            Template string used for rendering the information that
+            appear on hover box. Note that this will override
+            `hoverinfo`. Variables are inserted using %{variable},
+            for example "y: %{y}" as well as %{xother}, {%_xother},
+            {%_xother_}, {%xother_}. When showing info for several
+            points, "xother" will be added to those with different
+            x positions from the first point. An underscore before
+            or after "(x|y)other" will add a space on that side,
+            only when this field is shown. Numbers are formatted
+            using d3-format's syntax %{variable:d3-format}, for
+            example "Price: %{y:$.2f}".
+            https://github.com/d3/d3-format/tree/v1.4.5#d3-format
+            for details on the formatting syntax. Dates are
+            formatted using d3-time-format's syntax
+            %{variable|d3-time-format}, for example "Day:
+            %{2019-01-01|%A}". https://github.com/d3/d3-time-
+            format/tree/v2.2.3#locale_format for details on the
+            date formatting syntax. The variables available in
+            `hovertemplate` are the ones emitted as event data
+            described at this link
+            https://plotly.com/javascript/plotlyjs-events/#event-
+            data. Additionally, every attributes that can be
+            specified per-point (the ones that are `arrayOk: true`)
+            are available. variables `value` and `label`. Anything
+            contained in tag `<extra>` is displayed in the
+            secondary box, for example
+            "<extra>{fullData.name}</extra>". To hide the secondary
+            box completely, use an empty tag `<extra></extra>`.
+        hovertemplatesrc
+            Sets the source reference on Chart Studio Cloud for
+            `hovertemplate`.
+        label
+            The shown name of the link.
+        labelsrc
+            Sets the source reference on Chart Studio Cloud for
+            `label`.
+        line
+            :class:`plotly.graph_objects.sankey.link.Line` instance
+            or dict with compatible properties
+        source
+            An integer number `[0..nodes.length - 1]` that
+            represents the source node.
+        sourcesrc
+            Sets the source reference on Chart Studio Cloud for
+            `source`.
+        target
+            An integer number `[0..nodes.length - 1]` that
+            represents the target node.
+        targetsrc
+            Sets the source reference on Chart Studio Cloud for
+            `target`.
+        value
+            A numeric value representing the flow volume value.
+        valuesrc
+            Sets the source reference on Chart Studio Cloud for
+            `value`.
+
+        Returns
+        -------
+        Link
+        """
+        super(Link, self).__init__("link")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.Link
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.Link`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("colorscales", None)
+        _v = colorscales if colorscales is not None else _v
+        if _v is not None:
+            self["colorscales"] = _v
+        _v = arg.pop("colorscaledefaults", None)
+        _v = colorscaledefaults if colorscaledefaults is not None else _v
+        if _v is not None:
+            self["colorscaledefaults"] = _v
+        _v = arg.pop("colorsrc", None)
+        _v = colorsrc if colorsrc is not None else _v
+        if _v is not None:
+            self["colorsrc"] = _v
+        _v = arg.pop("customdata", None)
+        _v = customdata if customdata is not None else _v
+        if _v is not None:
+            self["customdata"] = _v
+        _v = arg.pop("customdatasrc", None)
+        _v = customdatasrc if customdatasrc is not None else _v
+        if _v is not None:
+            self["customdatasrc"] = _v
+        _v = arg.pop("hoverinfo", None)
+        _v = hoverinfo if hoverinfo is not None else _v
+        if _v is not None:
+            self["hoverinfo"] = _v
+        _v = arg.pop("hoverlabel", None)
+        _v = hoverlabel if hoverlabel is not None else _v
+        if _v is not None:
+            self["hoverlabel"] = _v
+        _v = arg.pop("hovertemplate", None)
+        _v = hovertemplate if hovertemplate is not None else _v
+        if _v is not None:
+            self["hovertemplate"] = _v
+        _v = arg.pop("hovertemplatesrc", None)
+        _v = hovertemplatesrc if hovertemplatesrc is not None else _v
+        if _v is not None:
+            self["hovertemplatesrc"] = _v
+        _v = arg.pop("label", None)
+        _v = label if label is not None else _v
+        if _v is not None:
+            self["label"] = _v
+        _v = arg.pop("labelsrc", None)
+        _v = labelsrc if labelsrc is not None else _v
+        if _v is not None:
+            self["labelsrc"] = _v
+        _v = arg.pop("line", None)
+        _v = line if line is not None else _v
+        if _v is not None:
+            self["line"] = _v
+        _v = arg.pop("source", None)
+        _v = source if source is not None else _v
+        if _v is not None:
+            self["source"] = _v
+        _v = arg.pop("sourcesrc", None)
+        _v = sourcesrc if sourcesrc is not None else _v
+        if _v is not None:
+            self["sourcesrc"] = _v
+        _v = arg.pop("target", None)
+        _v = target if target is not None else _v
+        if _v is not None:
+            self["target"] = _v
+        _v = arg.pop("targetsrc", None)
+        _v = targetsrc if targetsrc is not None else _v
+        if _v is not None:
+            self["targetsrc"] = _v
+        _v = arg.pop("value", None)
+        _v = value if value is not None else _v
+        if _v is not None:
+            self["value"] = _v
+        _v = arg.pop("valuesrc", None)
+        _v = valuesrc if valuesrc is not None else _v
+        if _v is not None:
+            self["valuesrc"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/_node.py

@@ -0,0 +1,842 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Node(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey"
+    _path_str = "sankey.node"
+    _valid_props = {
+        "color",
+        "colorsrc",
+        "customdata",
+        "customdatasrc",
+        "groups",
+        "hoverinfo",
+        "hoverlabel",
+        "hovertemplate",
+        "hovertemplatesrc",
+        "label",
+        "labelsrc",
+        "line",
+        "pad",
+        "thickness",
+        "x",
+        "xsrc",
+        "y",
+        "ysrc",
+    }
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        Sets the `node` color. It can be a single value, or an array
+        for specifying color for each `node`. If `node.color` is
+        omitted, then the default `Plotly` color palette will be cycled
+        through to have a variety of colors. These defaults are not
+        fully opaque, to allow some visibility of what is beneath the
+        node.
+
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # colorsrc
+    # --------
+    @property
+    def colorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `color`.
+
+        The 'colorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["colorsrc"]
+
+    @colorsrc.setter
+    def colorsrc(self, val):
+        self["colorsrc"] = val
+
+    # customdata
+    # ----------
+    @property
+    def customdata(self):
+        """
+        Assigns extra data to each node.
+
+        The 'customdata' property is an array that may be specified as a tuple,
+        list, numpy array, or pandas Series
+
+        Returns
+        -------
+        numpy.ndarray
+        """
+        return self["customdata"]
+
+    @customdata.setter
+    def customdata(self, val):
+        self["customdata"] = val
+
+    # customdatasrc
+    # -------------
+    @property
+    def customdatasrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `customdata`.
+
+        The 'customdatasrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["customdatasrc"]
+
+    @customdatasrc.setter
+    def customdatasrc(self, val):
+        self["customdatasrc"] = val
+
+    # groups
+    # ------
+    @property
+    def groups(self):
+        """
+        Groups of nodes. Each group is defined by an array with the
+        indices of the nodes it contains. Multiple groups can be
+        specified.
+
+        The 'groups' property is an info array that may be specified as:
+        * a 2D list where:
+          The 'groups[i][j]' property is a number and may be specified as:
+          - An int or float
+
+        Returns
+        -------
+        list
+        """
+        return self["groups"]
+
+    @groups.setter
+    def groups(self, val):
+        self["groups"] = val
+
+    # hoverinfo
+    # ---------
+    @property
+    def hoverinfo(self):
+        """
+        Determines which trace information appear when hovering nodes.
+        If `none` or `skip` are set, no information is displayed upon
+        hovering. But, if `none` is set, click and hover events are
+        still fired.
+
+        The 'hoverinfo' property is an enumeration that may be specified as:
+          - One of the following enumeration values:
+                ['all', 'none', 'skip']
+
+        Returns
+        -------
+        Any
+        """
+        return self["hoverinfo"]
+
+    @hoverinfo.setter
+    def hoverinfo(self, val):
+        self["hoverinfo"] = val
+
+    # hoverlabel
+    # ----------
+    @property
+    def hoverlabel(self):
+        """
+        The 'hoverlabel' property is an instance of Hoverlabel
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.sankey.node.Hoverlabel`
+          - A dict of string/value properties that will be passed
+            to the Hoverlabel constructor
+
+            Supported dict properties:
+
+                align
+                    Sets the horizontal alignment of the text
+                    content within hover label box. Has an effect
+                    only if the hover label text spans more two or
+                    more lines
+                alignsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `align`.
+                bgcolor
+                    Sets the background color of the hover labels
+                    for this trace
+                bgcolorsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `bgcolor`.
+                bordercolor
+                    Sets the border color of the hover labels for
+                    this trace.
+                bordercolorsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `bordercolor`.
+                font
+                    Sets the font used in hover labels.
+                namelength
+                    Sets the default length (in number of
+                    characters) of the trace name in the hover
+                    labels for all traces. -1 shows the whole name
+                    regardless of length. 0-3 shows the first 0-3
+                    characters, and an integer >3 will show the
+                    whole name if it is less than that many
+                    characters, but if it is longer, will truncate
+                    to `namelength - 3` characters and add an
+                    ellipsis.
+                namelengthsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `namelength`.
+
+        Returns
+        -------
+        plotly.graph_objs.sankey.node.Hoverlabel
+        """
+        return self["hoverlabel"]
+
+    @hoverlabel.setter
+    def hoverlabel(self, val):
+        self["hoverlabel"] = val
+
+    # hovertemplate
+    # -------------
+    @property
+    def hovertemplate(self):
+        """
+        Template string used for rendering the information that appear
+        on hover box. Note that this will override `hoverinfo`.
+        Variables are inserted using %{variable}, for example "y: %{y}"
+        as well as %{xother}, {%_xother}, {%_xother_}, {%xother_}. When
+        showing info for several points, "xother" will be added to
+        those with different x positions from the first point. An
+        underscore before or after "(x|y)other" will add a space on
+        that side, only when this field is shown. Numbers are formatted
+        using d3-format's syntax %{variable:d3-format}, for example
+        "Price: %{y:$.2f}".
+        https://github.com/d3/d3-format/tree/v1.4.5#d3-format for
+        details on the formatting syntax. Dates are formatted using
+        d3-time-format's syntax %{variable|d3-time-format}, for example
+        "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-
+        format/tree/v2.2.3#locale_format for details on the date
+        formatting syntax. The variables available in `hovertemplate`
+        are the ones emitted as event data described at this link
+        https://plotly.com/javascript/plotlyjs-events/#event-data.
+        Additionally, every attributes that can be specified per-point
+        (the ones that are `arrayOk: true`) are available. variables
+        `value` and `label`. Anything contained in tag `<extra>` is
+        displayed in the secondary box, for example
+        "<extra>{fullData.name}</extra>". To hide the secondary box
+        completely, use an empty tag `<extra></extra>`.
+
+        The 'hovertemplate' property is a string and must be specified as:
+          - A string
+          - A number that will be converted to a string
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["hovertemplate"]
+
+    @hovertemplate.setter
+    def hovertemplate(self, val):
+        self["hovertemplate"] = val
+
+    # hovertemplatesrc
+    # ----------------
+    @property
+    def hovertemplatesrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `hovertemplate`.
+
+        The 'hovertemplatesrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["hovertemplatesrc"]
+
+    @hovertemplatesrc.setter
+    def hovertemplatesrc(self, val):
+        self["hovertemplatesrc"] = val
+
+    # label
+    # -----
+    @property
+    def label(self):
+        """
+        The shown name of the node.
+
+        The 'label' property is an array that may be specified as a tuple,
+        list, numpy array, or pandas Series
+
+        Returns
+        -------
+        numpy.ndarray
+        """
+        return self["label"]
+
+    @label.setter
+    def label(self, val):
+        self["label"] = val
+
+    # labelsrc
+    # --------
+    @property
+    def labelsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `label`.
+
+        The 'labelsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["labelsrc"]
+
+    @labelsrc.setter
+    def labelsrc(self, val):
+        self["labelsrc"] = val
+
+    # line
+    # ----
+    @property
+    def line(self):
+        """
+        The 'line' property is an instance of Line
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.sankey.node.Line`
+          - A dict of string/value properties that will be passed
+            to the Line constructor
+
+            Supported dict properties:
+
+                color
+                    Sets the color of the `line` around each
+                    `node`.
+                colorsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `color`.
+                width
+                    Sets the width (in px) of the `line` around
+                    each `node`.
+                widthsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `width`.
+
+        Returns
+        -------
+        plotly.graph_objs.sankey.node.Line
+        """
+        return self["line"]
+
+    @line.setter
+    def line(self, val):
+        self["line"] = val
+
+    # pad
+    # ---
+    @property
+    def pad(self):
+        """
+        Sets the padding (in px) between the `nodes`.
+
+        The 'pad' property is a number and may be specified as:
+          - An int or float in the interval [0, inf]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["pad"]
+
+    @pad.setter
+    def pad(self, val):
+        self["pad"] = val
+
+    # thickness
+    # ---------
+    @property
+    def thickness(self):
+        """
+        Sets the thickness (in px) of the `nodes`.
+
+        The 'thickness' property is a number and may be specified as:
+          - An int or float in the interval [1, inf]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["thickness"]
+
+    @thickness.setter
+    def thickness(self, val):
+        self["thickness"] = val
+
+    # x
+    # -
+    @property
+    def x(self):
+        """
+        The normalized horizontal position of the node.
+
+        The 'x' property is an array that may be specified as a tuple,
+        list, numpy array, or pandas Series
+
+        Returns
+        -------
+        numpy.ndarray
+        """
+        return self["x"]
+
+    @x.setter
+    def x(self, val):
+        self["x"] = val
+
+    # xsrc
+    # ----
+    @property
+    def xsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `x`.
+
+        The 'xsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["xsrc"]
+
+    @xsrc.setter
+    def xsrc(self, val):
+        self["xsrc"] = val
+
+    # y
+    # -
+    @property
+    def y(self):
+        """
+        The normalized vertical position of the node.
+
+        The 'y' property is an array that may be specified as a tuple,
+        list, numpy array, or pandas Series
+
+        Returns
+        -------
+        numpy.ndarray
+        """
+        return self["y"]
+
+    @y.setter
+    def y(self, val):
+        self["y"] = val
+
+    # ysrc
+    # ----
+    @property
+    def ysrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `y`.
+
+        The 'ysrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["ysrc"]
+
+    @ysrc.setter
+    def ysrc(self, val):
+        self["ysrc"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+            Sets the `node` color. It can be a single value, or an
+            array for specifying color for each `node`. If
+            `node.color` is omitted, then the default `Plotly`
+            color palette will be cycled through to have a variety
+            of colors. These defaults are not fully opaque, to
+            allow some visibility of what is beneath the node.
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        customdata
+            Assigns extra data to each node.
+        customdatasrc
+            Sets the source reference on Chart Studio Cloud for
+            `customdata`.
+        groups
+            Groups of nodes. Each group is defined by an array with
+            the indices of the nodes it contains. Multiple groups
+            can be specified.
+        hoverinfo
+            Determines which trace information appear when hovering
+            nodes. If `none` or `skip` are set, no information is
+            displayed upon hovering. But, if `none` is set, click
+            and hover events are still fired.
+        hoverlabel
+            :class:`plotly.graph_objects.sankey.node.Hoverlabel`
+            instance or dict with compatible properties
+        hovertemplate
+            Template string used for rendering the information that
+            appear on hover box. Note that this will override
+            `hoverinfo`. Variables are inserted using %{variable},
+            for example "y: %{y}" as well as %{xother}, {%_xother},
+            {%_xother_}, {%xother_}. When showing info for several
+            points, "xother" will be added to those with different
+            x positions from the first point. An underscore before
+            or after "(x|y)other" will add a space on that side,
+            only when this field is shown. Numbers are formatted
+            using d3-format's syntax %{variable:d3-format}, for
+            example "Price: %{y:$.2f}".
+            https://github.com/d3/d3-format/tree/v1.4.5#d3-format
+            for details on the formatting syntax. Dates are
+            formatted using d3-time-format's syntax
+            %{variable|d3-time-format}, for example "Day:
+            %{2019-01-01|%A}". https://github.com/d3/d3-time-
+            format/tree/v2.2.3#locale_format for details on the
+            date formatting syntax. The variables available in
+            `hovertemplate` are the ones emitted as event data
+            described at this link
+            https://plotly.com/javascript/plotlyjs-events/#event-
+            data. Additionally, every attributes that can be
+            specified per-point (the ones that are `arrayOk: true`)
+            are available. variables `value` and `label`. Anything
+            contained in tag `<extra>` is displayed in the
+            secondary box, for example
+            "<extra>{fullData.name}</extra>". To hide the secondary
+            box completely, use an empty tag `<extra></extra>`.
+        hovertemplatesrc
+            Sets the source reference on Chart Studio Cloud for
+            `hovertemplate`.
+        label
+            The shown name of the node.
+        labelsrc
+            Sets the source reference on Chart Studio Cloud for
+            `label`.
+        line
+            :class:`plotly.graph_objects.sankey.node.Line` instance
+            or dict with compatible properties
+        pad
+            Sets the padding (in px) between the `nodes`.
+        thickness
+            Sets the thickness (in px) of the `nodes`.
+        x
+            The normalized horizontal position of the node.
+        xsrc
+            Sets the source reference on Chart Studio Cloud for
+            `x`.
+        y
+            The normalized vertical position of the node.
+        ysrc
+            Sets the source reference on Chart Studio Cloud for
+            `y`.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        color=None,
+        colorsrc=None,
+        customdata=None,
+        customdatasrc=None,
+        groups=None,
+        hoverinfo=None,
+        hoverlabel=None,
+        hovertemplate=None,
+        hovertemplatesrc=None,
+        label=None,
+        labelsrc=None,
+        line=None,
+        pad=None,
+        thickness=None,
+        x=None,
+        xsrc=None,
+        y=None,
+        ysrc=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Node object
+
+        The nodes of the Sankey plot.
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of :class:`plotly.graph_objs.sankey.Node`
+        color
+            Sets the `node` color. It can be a single value, or an
+            array for specifying color for each `node`. If
+            `node.color` is omitted, then the default `Plotly`
+            color palette will be cycled through to have a variety
+            of colors. These defaults are not fully opaque, to
+            allow some visibility of what is beneath the node.
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        customdata
+            Assigns extra data to each node.
+        customdatasrc
+            Sets the source reference on Chart Studio Cloud for
+            `customdata`.
+        groups
+            Groups of nodes. Each group is defined by an array with
+            the indices of the nodes it contains. Multiple groups
+            can be specified.
+        hoverinfo
+            Determines which trace information appear when hovering
+            nodes. If `none` or `skip` are set, no information is
+            displayed upon hovering. But, if `none` is set, click
+            and hover events are still fired.
+        hoverlabel
+            :class:`plotly.graph_objects.sankey.node.Hoverlabel`
+            instance or dict with compatible properties
+        hovertemplate
+            Template string used for rendering the information that
+            appear on hover box. Note that this will override
+            `hoverinfo`. Variables are inserted using %{variable},
+            for example "y: %{y}" as well as %{xother}, {%_xother},
+            {%_xother_}, {%xother_}. When showing info for several
+            points, "xother" will be added to those with different
+            x positions from the first point. An underscore before
+            or after "(x|y)other" will add a space on that side,
+            only when this field is shown. Numbers are formatted
+            using d3-format's syntax %{variable:d3-format}, for
+            example "Price: %{y:$.2f}".
+            https://github.com/d3/d3-format/tree/v1.4.5#d3-format
+            for details on the formatting syntax. Dates are
+            formatted using d3-time-format's syntax
+            %{variable|d3-time-format}, for example "Day:
+            %{2019-01-01|%A}". https://github.com/d3/d3-time-
+            format/tree/v2.2.3#locale_format for details on the
+            date formatting syntax. The variables available in
+            `hovertemplate` are the ones emitted as event data
+            described at this link
+            https://plotly.com/javascript/plotlyjs-events/#event-
+            data. Additionally, every attributes that can be
+            specified per-point (the ones that are `arrayOk: true`)
+            are available. variables `value` and `label`. Anything
+            contained in tag `<extra>` is displayed in the
+            secondary box, for example
+            "<extra>{fullData.name}</extra>". To hide the secondary
+            box completely, use an empty tag `<extra></extra>`.
+        hovertemplatesrc
+            Sets the source reference on Chart Studio Cloud for
+            `hovertemplate`.
+        label
+            The shown name of the node.
+        labelsrc
+            Sets the source reference on Chart Studio Cloud for
+            `label`.
+        line
+            :class:`plotly.graph_objects.sankey.node.Line` instance
+            or dict with compatible properties
+        pad
+            Sets the padding (in px) between the `nodes`.
+        thickness
+            Sets the thickness (in px) of the `nodes`.
+        x
+            The normalized horizontal position of the node.
+        xsrc
+            Sets the source reference on Chart Studio Cloud for
+            `x`.
+        y
+            The normalized vertical position of the node.
+        ysrc
+            Sets the source reference on Chart Studio Cloud for
+            `y`.
+
+        Returns
+        -------
+        Node
+        """
+        super(Node, self).__init__("node")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.Node
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.Node`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("colorsrc", None)
+        _v = colorsrc if colorsrc is not None else _v
+        if _v is not None:
+            self["colorsrc"] = _v
+        _v = arg.pop("customdata", None)
+        _v = customdata if customdata is not None else _v
+        if _v is not None:
+            self["customdata"] = _v
+        _v = arg.pop("customdatasrc", None)
+        _v = customdatasrc if customdatasrc is not None else _v
+        if _v is not None:
+            self["customdatasrc"] = _v
+        _v = arg.pop("groups", None)
+        _v = groups if groups is not None else _v
+        if _v is not None:
+            self["groups"] = _v
+        _v = arg.pop("hoverinfo", None)
+        _v = hoverinfo if hoverinfo is not None else _v
+        if _v is not None:
+            self["hoverinfo"] = _v
+        _v = arg.pop("hoverlabel", None)
+        _v = hoverlabel if hoverlabel is not None else _v
+        if _v is not None:
+            self["hoverlabel"] = _v
+        _v = arg.pop("hovertemplate", None)
+        _v = hovertemplate if hovertemplate is not None else _v
+        if _v is not None:
+            self["hovertemplate"] = _v
+        _v = arg.pop("hovertemplatesrc", None)
+        _v = hovertemplatesrc if hovertemplatesrc is not None else _v
+        if _v is not None:
+            self["hovertemplatesrc"] = _v
+        _v = arg.pop("label", None)
+        _v = label if label is not None else _v
+        if _v is not None:
+            self["label"] = _v
+        _v = arg.pop("labelsrc", None)
+        _v = labelsrc if labelsrc is not None else _v
+        if _v is not None:
+            self["labelsrc"] = _v
+        _v = arg.pop("line", None)
+        _v = line if line is not None else _v
+        if _v is not None:
+            self["line"] = _v
+        _v = arg.pop("pad", None)
+        _v = pad if pad is not None else _v
+        if _v is not None:
+            self["pad"] = _v
+        _v = arg.pop("thickness", None)
+        _v = thickness if thickness is not None else _v
+        if _v is not None:
+            self["thickness"] = _v
+        _v = arg.pop("x", None)
+        _v = x if x is not None else _v
+        if _v is not None:
+            self["x"] = _v
+        _v = arg.pop("xsrc", None)
+        _v = xsrc if xsrc is not None else _v
+        if _v is not None:
+            self["xsrc"] = _v
+        _v = arg.pop("y", None)
+        _v = y if y is not None else _v
+        if _v is not None:
+            self["y"] = _v
+        _v = arg.pop("ysrc", None)
+        _v = ysrc if ysrc is not None else _v
+        if _v is not None:
+            self["ysrc"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/_stream.py

@@ -0,0 +1,140 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Stream(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey"
+    _path_str = "sankey.stream"
+    _valid_props = {"maxpoints", "token"}
+
+    # maxpoints
+    # ---------
+    @property
+    def maxpoints(self):
+        """
+        Sets the maximum number of points to keep on the plots from an
+        incoming stream. If `maxpoints` is set to 50, only the newest
+        50 points will be displayed on the plot.
+
+        The 'maxpoints' property is a number and may be specified as:
+          - An int or float in the interval [0, 10000]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["maxpoints"]
+
+    @maxpoints.setter
+    def maxpoints(self, val):
+        self["maxpoints"] = val
+
+    # token
+    # -----
+    @property
+    def token(self):
+        """
+        The stream id number links a data trace on a plot with a
+        stream. See https://chart-studio.plotly.com/settings for more
+        details.
+
+        The 'token' property is a string and must be specified as:
+          - A non-empty string
+
+        Returns
+        -------
+        str
+        """
+        return self["token"]
+
+    @token.setter
+    def token(self, val):
+        self["token"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        maxpoints
+            Sets the maximum number of points to keep on the plots
+            from an incoming stream. If `maxpoints` is set to 50,
+            only the newest 50 points will be displayed on the
+            plot.
+        token
+            The stream id number links a data trace on a plot with
+            a stream. See https://chart-studio.plotly.com/settings
+            for more details.
+        """
+
+    def __init__(self, arg=None, maxpoints=None, token=None, **kwargs):
+        """
+        Construct a new Stream object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of :class:`plotly.graph_objs.sankey.Stream`
+        maxpoints
+            Sets the maximum number of points to keep on the plots
+            from an incoming stream. If `maxpoints` is set to 50,
+            only the newest 50 points will be displayed on the
+            plot.
+        token
+            The stream id number links a data trace on a plot with
+            a stream. See https://chart-studio.plotly.com/settings
+            for more details.
+
+        Returns
+        -------
+        Stream
+        """
+        super(Stream, self).__init__("stream")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.Stream
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.Stream`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("maxpoints", None)
+        _v = maxpoints if maxpoints is not None else _v
+        if _v is not None:
+            self["maxpoints"] = _v
+        _v = arg.pop("token", None)
+        _v = token if token is not None else _v
+        if _v is not None:
+            self["token"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/_textfont.py

@@ -0,0 +1,227 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Textfont(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey"
+    _path_str = "sankey.textfont"
+    _valid_props = {"color", "family", "size"}
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+
+        Returns
+        -------
+        str
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # family
+    # ------
+    @property
+    def family(self):
+        """
+        HTML font family - the typeface that will be applied by the web
+        browser. The web browser will only be able to apply a font if
+        it is available on the system which it operates. Provide
+        multiple font families, separated by commas, to indicate the
+        preference in which to apply fonts if they aren't available on
+        the system. The Chart Studio Cloud (at https://chart-
+        studio.plotly.com or on-premise) generates images on a server,
+        where only a select number of fonts are installed and
+        supported. These include "Arial", "Balto", "Courier New",
+        "Droid Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+        One", "Old Standard TT", "Open Sans", "Overpass", "PT Sans
+        Narrow", "Raleway", "Times New Roman".
+
+        The 'family' property is a string and must be specified as:
+          - A non-empty string
+
+        Returns
+        -------
+        str
+        """
+        return self["family"]
+
+    @family.setter
+    def family(self, val):
+        self["family"] = val
+
+    # size
+    # ----
+    @property
+    def size(self):
+        """
+        The 'size' property is a number and may be specified as:
+          - An int or float in the interval [1, inf]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["size"]
+
+    @size.setter
+    def size(self, val):
+        self["size"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        size
+
+        """
+
+    def __init__(self, arg=None, color=None, family=None, size=None, **kwargs):
+        """
+        Construct a new Textfont object
+
+        Sets the font for node labels
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.sankey.Textfont`
+        color
+
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        size
+
+
+        Returns
+        -------
+        Textfont
+        """
+        super(Textfont, self).__init__("textfont")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.Textfont
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.Textfont`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("family", None)
+        _v = family if family is not None else _v
+        if _v is not None:
+            self["family"] = _v
+        _v = arg.pop("size", None)
+        _v = size if size is not None else _v
+        if _v is not None:
+            self["size"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/hoverlabel/__init__.py

@@ -0,0 +1,9 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._font import Font
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(__name__, [], ["._font.Font"])

.venv/Lib/site-packages/plotly/graph_objs/sankey/hoverlabel/_font.py

@@ -0,0 +1,330 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Font(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey.hoverlabel"
+    _path_str = "sankey.hoverlabel.font"
+    _valid_props = {"color", "colorsrc", "family", "familysrc", "size", "sizesrc"}
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # colorsrc
+    # --------
+    @property
+    def colorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `color`.
+
+        The 'colorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["colorsrc"]
+
+    @colorsrc.setter
+    def colorsrc(self, val):
+        self["colorsrc"] = val
+
+    # family
+    # ------
+    @property
+    def family(self):
+        """
+        HTML font family - the typeface that will be applied by the web
+        browser. The web browser will only be able to apply a font if
+        it is available on the system which it operates. Provide
+        multiple font families, separated by commas, to indicate the
+        preference in which to apply fonts if they aren't available on
+        the system. The Chart Studio Cloud (at https://chart-
+        studio.plotly.com or on-premise) generates images on a server,
+        where only a select number of fonts are installed and
+        supported. These include "Arial", "Balto", "Courier New",
+        "Droid Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+        One", "Old Standard TT", "Open Sans", "Overpass", "PT Sans
+        Narrow", "Raleway", "Times New Roman".
+
+        The 'family' property is a string and must be specified as:
+          - A non-empty string
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["family"]
+
+    @family.setter
+    def family(self, val):
+        self["family"] = val
+
+    # familysrc
+    # ---------
+    @property
+    def familysrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `family`.
+
+        The 'familysrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["familysrc"]
+
+    @familysrc.setter
+    def familysrc(self, val):
+        self["familysrc"] = val
+
+    # size
+    # ----
+    @property
+    def size(self):
+        """
+        The 'size' property is a number and may be specified as:
+          - An int or float in the interval [1, inf]
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        int|float|numpy.ndarray
+        """
+        return self["size"]
+
+    @size.setter
+    def size(self, val):
+        self["size"] = val
+
+    # sizesrc
+    # -------
+    @property
+    def sizesrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `size`.
+
+        The 'sizesrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["sizesrc"]
+
+    @sizesrc.setter
+    def sizesrc(self, val):
+        self["sizesrc"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        familysrc
+            Sets the source reference on Chart Studio Cloud for
+            `family`.
+        size
+
+        sizesrc
+            Sets the source reference on Chart Studio Cloud for
+            `size`.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        color=None,
+        colorsrc=None,
+        family=None,
+        familysrc=None,
+        size=None,
+        sizesrc=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Font object
+
+        Sets the font used in hover labels.
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.sankey.hoverlabel.Font`
+        color
+
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        familysrc
+            Sets the source reference on Chart Studio Cloud for
+            `family`.
+        size
+
+        sizesrc
+            Sets the source reference on Chart Studio Cloud for
+            `size`.
+
+        Returns
+        -------
+        Font
+        """
+        super(Font, self).__init__("font")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.hoverlabel.Font
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.hoverlabel.Font`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("colorsrc", None)
+        _v = colorsrc if colorsrc is not None else _v
+        if _v is not None:
+            self["colorsrc"] = _v
+        _v = arg.pop("family", None)
+        _v = family if family is not None else _v
+        if _v is not None:
+            self["family"] = _v
+        _v = arg.pop("familysrc", None)
+        _v = familysrc if familysrc is not None else _v
+        if _v is not None:
+            self["familysrc"] = _v
+        _v = arg.pop("size", None)
+        _v = size if size is not None else _v
+        if _v is not None:
+            self["size"] = _v
+        _v = arg.pop("sizesrc", None)
+        _v = sizesrc if sizesrc is not None else _v
+        if _v is not None:
+            self["sizesrc"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/legendgrouptitle/__init__.py

@@ -0,0 +1,9 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._font import Font
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(__name__, [], ["._font.Font"])

.venv/Lib/site-packages/plotly/graph_objs/sankey/legendgrouptitle/_font.py

@@ -0,0 +1,227 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Font(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey.legendgrouptitle"
+    _path_str = "sankey.legendgrouptitle.font"
+    _valid_props = {"color", "family", "size"}
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+
+        Returns
+        -------
+        str
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # family
+    # ------
+    @property
+    def family(self):
+        """
+        HTML font family - the typeface that will be applied by the web
+        browser. The web browser will only be able to apply a font if
+        it is available on the system which it operates. Provide
+        multiple font families, separated by commas, to indicate the
+        preference in which to apply fonts if they aren't available on
+        the system. The Chart Studio Cloud (at https://chart-
+        studio.plotly.com or on-premise) generates images on a server,
+        where only a select number of fonts are installed and
+        supported. These include "Arial", "Balto", "Courier New",
+        "Droid Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+        One", "Old Standard TT", "Open Sans", "Overpass", "PT Sans
+        Narrow", "Raleway", "Times New Roman".
+
+        The 'family' property is a string and must be specified as:
+          - A non-empty string
+
+        Returns
+        -------
+        str
+        """
+        return self["family"]
+
+    @family.setter
+    def family(self, val):
+        self["family"] = val
+
+    # size
+    # ----
+    @property
+    def size(self):
+        """
+        The 'size' property is a number and may be specified as:
+          - An int or float in the interval [1, inf]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["size"]
+
+    @size.setter
+    def size(self, val):
+        self["size"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        size
+
+        """
+
+    def __init__(self, arg=None, color=None, family=None, size=None, **kwargs):
+        """
+        Construct a new Font object
+
+        Sets this legend group's title font.
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.sankey.legendgrouptitle.Font`
+        color
+
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        size
+
+
+        Returns
+        -------
+        Font
+        """
+        super(Font, self).__init__("font")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.legendgrouptitle.Font
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.legendgrouptitle.Font`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("family", None)
+        _v = family if family is not None else _v
+        if _v is not None:
+            self["family"] = _v
+        _v = arg.pop("size", None)
+        _v = size if size is not None else _v
+        if _v is not None:
+            self["size"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/link/__init__.py

@@ -0,0 +1,16 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._colorscale import Colorscale
+    from ._hoverlabel import Hoverlabel
+    from ._line import Line
+    from . import hoverlabel
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(
+        __name__,
+        [".hoverlabel"],
+        ["._colorscale.Colorscale", "._hoverlabel.Hoverlabel", "._line.Line"],
+    )

.venv/Lib/site-packages/plotly/graph_objs/sankey/link/_colorscale.py

@@ -0,0 +1,351 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Colorscale(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey.link"
+    _path_str = "sankey.link.colorscale"
+    _valid_props = {"cmax", "cmin", "colorscale", "label", "name", "templateitemname"}
+
+    # cmax
+    # ----
+    @property
+    def cmax(self):
+        """
+        Sets the upper bound of the color domain.
+
+        The 'cmax' property is a number and may be specified as:
+          - An int or float
+
+        Returns
+        -------
+        int|float
+        """
+        return self["cmax"]
+
+    @cmax.setter
+    def cmax(self, val):
+        self["cmax"] = val
+
+    # cmin
+    # ----
+    @property
+    def cmin(self):
+        """
+        Sets the lower bound of the color domain.
+
+        The 'cmin' property is a number and may be specified as:
+          - An int or float
+
+        Returns
+        -------
+        int|float
+        """
+        return self["cmin"]
+
+    @cmin.setter
+    def cmin(self, val):
+        self["cmin"] = val
+
+    # colorscale
+    # ----------
+    @property
+    def colorscale(self):
+        """
+        Sets the colorscale. The colorscale must be an array containing
+        arrays mapping a normalized value to an rgb, rgba, hex, hsl,
+        hsv, or named color string. At minimum, a mapping for the
+        lowest (0) and highest (1) values are required. For example,
+        `[[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]`. To control the
+        bounds of the colorscale in color space, use `cmin` and `cmax`.
+        Alternatively, `colorscale` may be a palette name string of the
+        following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,
+        Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,
+        YlGnBu,YlOrRd.
+
+        The 'colorscale' property is a colorscale and may be
+        specified as:
+          - A list of colors that will be spaced evenly to create the colorscale.
+            Many predefined colorscale lists are included in the sequential, diverging,
+            and cyclical modules in the plotly.colors package.
+          - A list of 2-element lists where the first element is the
+            normalized color level value (starting at 0 and ending at 1),
+            and the second item is a valid color string.
+            (e.g. [[0, 'green'], [0.5, 'red'], [1.0, 'rgb(0, 0, 255)']])
+          - One of the following named colorscales:
+                ['aggrnyl', 'agsunset', 'algae', 'amp', 'armyrose', 'balance',
+                 'blackbody', 'bluered', 'blues', 'blugrn', 'bluyl', 'brbg',
+                 'brwnyl', 'bugn', 'bupu', 'burg', 'burgyl', 'cividis', 'curl',
+                 'darkmint', 'deep', 'delta', 'dense', 'earth', 'edge', 'electric',
+                 'emrld', 'fall', 'geyser', 'gnbu', 'gray', 'greens', 'greys',
+                 'haline', 'hot', 'hsv', 'ice', 'icefire', 'inferno', 'jet',
+                 'magenta', 'magma', 'matter', 'mint', 'mrybm', 'mygbm', 'oranges',
+                 'orrd', 'oryel', 'oxy', 'peach', 'phase', 'picnic', 'pinkyl',
+                 'piyg', 'plasma', 'plotly3', 'portland', 'prgn', 'pubu', 'pubugn',
+                 'puor', 'purd', 'purp', 'purples', 'purpor', 'rainbow', 'rdbu',
+                 'rdgy', 'rdpu', 'rdylbu', 'rdylgn', 'redor', 'reds', 'solar',
+                 'spectral', 'speed', 'sunset', 'sunsetdark', 'teal', 'tealgrn',
+                 'tealrose', 'tempo', 'temps', 'thermal', 'tropic', 'turbid',
+                 'turbo', 'twilight', 'viridis', 'ylgn', 'ylgnbu', 'ylorbr',
+                 'ylorrd'].
+            Appending '_r' to a named colorscale reverses it.
+
+        Returns
+        -------
+        str
+        """
+        return self["colorscale"]
+
+    @colorscale.setter
+    def colorscale(self, val):
+        self["colorscale"] = val
+
+    # label
+    # -----
+    @property
+    def label(self):
+        """
+        The label of the links to color based on their concentration
+        within a flow.
+
+        The 'label' property is a string and must be specified as:
+          - A string
+          - A number that will be converted to a string
+
+        Returns
+        -------
+        str
+        """
+        return self["label"]
+
+    @label.setter
+    def label(self, val):
+        self["label"] = val
+
+    # name
+    # ----
+    @property
+    def name(self):
+        """
+        When used in a template, named items are created in the output
+        figure in addition to any items the figure already has in this
+        array. You can modify these items in the output figure by
+        making your own item with `templateitemname` matching this
+        `name` alongside your modifications (including `visible: false`
+        or `enabled: false` to hide it). Has no effect outside of a
+        template.
+
+        The 'name' property is a string and must be specified as:
+          - A string
+          - A number that will be converted to a string
+
+        Returns
+        -------
+        str
+        """
+        return self["name"]
+
+    @name.setter
+    def name(self, val):
+        self["name"] = val
+
+    # templateitemname
+    # ----------------
+    @property
+    def templateitemname(self):
+        """
+        Used to refer to a named item in this array in the template.
+        Named items from the template will be created even without a
+        matching item in the input figure, but you can modify one by
+        making an item with `templateitemname` matching its `name`,
+        alongside your modifications (including `visible: false` or
+        `enabled: false` to hide it). If there is no template or no
+        matching item, this item will be hidden unless you explicitly
+        show it with `visible: true`.
+
+        The 'templateitemname' property is a string and must be specified as:
+          - A string
+          - A number that will be converted to a string
+
+        Returns
+        -------
+        str
+        """
+        return self["templateitemname"]
+
+    @templateitemname.setter
+    def templateitemname(self, val):
+        self["templateitemname"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        cmax
+            Sets the upper bound of the color domain.
+        cmin
+            Sets the lower bound of the color domain.
+        colorscale
+            Sets the colorscale. The colorscale must be an array
+            containing arrays mapping a normalized value to an rgb,
+            rgba, hex, hsl, hsv, or named color string. At minimum,
+            a mapping for the lowest (0) and highest (1) values are
+            required. For example, `[[0, 'rgb(0,0,255)'], [1,
+            'rgb(255,0,0)']]`. To control the bounds of the
+            colorscale in color space, use `cmin` and `cmax`.
+            Alternatively, `colorscale` may be a palette name
+            string of the following list: Blackbody,Bluered,Blues,C
+            ividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portl
+            and,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
+        label
+            The label of the links to color based on their
+            concentration within a flow.
+        name
+            When used in a template, named items are created in the
+            output figure in addition to any items the figure
+            already has in this array. You can modify these items
+            in the output figure by making your own item with
+            `templateitemname` matching this `name` alongside your
+            modifications (including `visible: false` or `enabled:
+            false` to hide it). Has no effect outside of a
+            template.
+        templateitemname
+            Used to refer to a named item in this array in the
+            template. Named items from the template will be created
+            even without a matching item in the input figure, but
+            you can modify one by making an item with
+            `templateitemname` matching its `name`, alongside your
+            modifications (including `visible: false` or `enabled:
+            false` to hide it). If there is no template or no
+            matching item, this item will be hidden unless you
+            explicitly show it with `visible: true`.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        cmax=None,
+        cmin=None,
+        colorscale=None,
+        label=None,
+        name=None,
+        templateitemname=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Colorscale object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.sankey.link.Colorscale`
+        cmax
+            Sets the upper bound of the color domain.
+        cmin
+            Sets the lower bound of the color domain.
+        colorscale
+            Sets the colorscale. The colorscale must be an array
+            containing arrays mapping a normalized value to an rgb,
+            rgba, hex, hsl, hsv, or named color string. At minimum,
+            a mapping for the lowest (0) and highest (1) values are
+            required. For example, `[[0, 'rgb(0,0,255)'], [1,
+            'rgb(255,0,0)']]`. To control the bounds of the
+            colorscale in color space, use `cmin` and `cmax`.
+            Alternatively, `colorscale` may be a palette name
+            string of the following list: Blackbody,Bluered,Blues,C
+            ividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portl
+            and,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
+        label
+            The label of the links to color based on their
+            concentration within a flow.
+        name
+            When used in a template, named items are created in the
+            output figure in addition to any items the figure
+            already has in this array. You can modify these items
+            in the output figure by making your own item with
+            `templateitemname` matching this `name` alongside your
+            modifications (including `visible: false` or `enabled:
+            false` to hide it). Has no effect outside of a
+            template.
+        templateitemname
+            Used to refer to a named item in this array in the
+            template. Named items from the template will be created
+            even without a matching item in the input figure, but
+            you can modify one by making an item with
+            `templateitemname` matching its `name`, alongside your
+            modifications (including `visible: false` or `enabled:
+            false` to hide it). If there is no template or no
+            matching item, this item will be hidden unless you
+            explicitly show it with `visible: true`.
+
+        Returns
+        -------
+        Colorscale
+        """
+        super(Colorscale, self).__init__("colorscales")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.link.Colorscale
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.link.Colorscale`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("cmax", None)
+        _v = cmax if cmax is not None else _v
+        if _v is not None:
+            self["cmax"] = _v
+        _v = arg.pop("cmin", None)
+        _v = cmin if cmin is not None else _v
+        if _v is not None:
+            self["cmin"] = _v
+        _v = arg.pop("colorscale", None)
+        _v = colorscale if colorscale is not None else _v
+        if _v is not None:
+            self["colorscale"] = _v
+        _v = arg.pop("label", None)
+        _v = label if label is not None else _v
+        if _v is not None:
+            self["label"] = _v
+        _v = arg.pop("name", None)
+        _v = name if name is not None else _v
+        if _v is not None:
+            self["name"] = _v
+        _v = arg.pop("templateitemname", None)
+        _v = templateitemname if templateitemname is not None else _v
+        if _v is not None:
+            self["templateitemname"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/link/_hoverlabel.py

@@ -0,0 +1,503 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Hoverlabel(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey.link"
+    _path_str = "sankey.link.hoverlabel"
+    _valid_props = {
+        "align",
+        "alignsrc",
+        "bgcolor",
+        "bgcolorsrc",
+        "bordercolor",
+        "bordercolorsrc",
+        "font",
+        "namelength",
+        "namelengthsrc",
+    }
+
+    # align
+    # -----
+    @property
+    def align(self):
+        """
+        Sets the horizontal alignment of the text content within hover
+        label box. Has an effect only if the hover label text spans
+        more two or more lines
+
+        The 'align' property is an enumeration that may be specified as:
+          - One of the following enumeration values:
+                ['left', 'right', 'auto']
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        Any|numpy.ndarray
+        """
+        return self["align"]
+
+    @align.setter
+    def align(self, val):
+        self["align"] = val
+
+    # alignsrc
+    # --------
+    @property
+    def alignsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `align`.
+
+        The 'alignsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["alignsrc"]
+
+    @alignsrc.setter
+    def alignsrc(self, val):
+        self["alignsrc"] = val
+
+    # bgcolor
+    # -------
+    @property
+    def bgcolor(self):
+        """
+        Sets the background color of the hover labels for this trace
+
+        The 'bgcolor' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["bgcolor"]
+
+    @bgcolor.setter
+    def bgcolor(self, val):
+        self["bgcolor"] = val
+
+    # bgcolorsrc
+    # ----------
+    @property
+    def bgcolorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `bgcolor`.
+
+        The 'bgcolorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["bgcolorsrc"]
+
+    @bgcolorsrc.setter
+    def bgcolorsrc(self, val):
+        self["bgcolorsrc"] = val
+
+    # bordercolor
+    # -----------
+    @property
+    def bordercolor(self):
+        """
+        Sets the border color of the hover labels for this trace.
+
+        The 'bordercolor' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["bordercolor"]
+
+    @bordercolor.setter
+    def bordercolor(self, val):
+        self["bordercolor"] = val
+
+    # bordercolorsrc
+    # --------------
+    @property
+    def bordercolorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `bordercolor`.
+
+        The 'bordercolorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["bordercolorsrc"]
+
+    @bordercolorsrc.setter
+    def bordercolorsrc(self, val):
+        self["bordercolorsrc"] = val
+
+    # font
+    # ----
+    @property
+    def font(self):
+        """
+        Sets the font used in hover labels.
+
+        The 'font' property is an instance of Font
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.sankey.link.hoverlabel.Font`
+          - A dict of string/value properties that will be passed
+            to the Font constructor
+
+            Supported dict properties:
+
+                color
+
+                colorsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `color`.
+                family
+                    HTML font family - the typeface that will be
+                    applied by the web browser. The web browser
+                    will only be able to apply a font if it is
+                    available on the system which it operates.
+                    Provide multiple font families, separated by
+                    commas, to indicate the preference in which to
+                    apply fonts if they aren't available on the
+                    system. The Chart Studio Cloud (at
+                    https://chart-studio.plotly.com or on-premise)
+                    generates images on a server, where only a
+                    select number of fonts are installed and
+                    supported. These include "Arial", "Balto",
+                    "Courier New", "Droid Sans",, "Droid Serif",
+                    "Droid Sans Mono", "Gravitas One", "Old
+                    Standard TT", "Open Sans", "Overpass", "PT Sans
+                    Narrow", "Raleway", "Times New Roman".
+                familysrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `family`.
+                size
+
+                sizesrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `size`.
+
+        Returns
+        -------
+        plotly.graph_objs.sankey.link.hoverlabel.Font
+        """
+        return self["font"]
+
+    @font.setter
+    def font(self, val):
+        self["font"] = val
+
+    # namelength
+    # ----------
+    @property
+    def namelength(self):
+        """
+        Sets the default length (in number of characters) of the trace
+        name in the hover labels for all traces. -1 shows the whole
+        name regardless of length. 0-3 shows the first 0-3 characters,
+        and an integer >3 will show the whole name if it is less than
+        that many characters, but if it is longer, will truncate to
+        `namelength - 3` characters and add an ellipsis.
+
+        The 'namelength' property is a integer and may be specified as:
+          - An int (or float that will be cast to an int)
+            in the interval [-1, 9223372036854775807]
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        int|numpy.ndarray
+        """
+        return self["namelength"]
+
+    @namelength.setter
+    def namelength(self, val):
+        self["namelength"] = val
+
+    # namelengthsrc
+    # -------------
+    @property
+    def namelengthsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `namelength`.
+
+        The 'namelengthsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["namelengthsrc"]
+
+    @namelengthsrc.setter
+    def namelengthsrc(self, val):
+        self["namelengthsrc"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        align
+            Sets the horizontal alignment of the text content
+            within hover label box. Has an effect only if the hover
+            label text spans more two or more lines
+        alignsrc
+            Sets the source reference on Chart Studio Cloud for
+            `align`.
+        bgcolor
+            Sets the background color of the hover labels for this
+            trace
+        bgcolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bgcolor`.
+        bordercolor
+            Sets the border color of the hover labels for this
+            trace.
+        bordercolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bordercolor`.
+        font
+            Sets the font used in hover labels.
+        namelength
+            Sets the default length (in number of characters) of
+            the trace name in the hover labels for all traces. -1
+            shows the whole name regardless of length. 0-3 shows
+            the first 0-3 characters, and an integer >3 will show
+            the whole name if it is less than that many characters,
+            but if it is longer, will truncate to `namelength - 3`
+            characters and add an ellipsis.
+        namelengthsrc
+            Sets the source reference on Chart Studio Cloud for
+            `namelength`.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        align=None,
+        alignsrc=None,
+        bgcolor=None,
+        bgcolorsrc=None,
+        bordercolor=None,
+        bordercolorsrc=None,
+        font=None,
+        namelength=None,
+        namelengthsrc=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Hoverlabel object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.sankey.link.Hoverlabel`
+        align
+            Sets the horizontal alignment of the text content
+            within hover label box. Has an effect only if the hover
+            label text spans more two or more lines
+        alignsrc
+            Sets the source reference on Chart Studio Cloud for
+            `align`.
+        bgcolor
+            Sets the background color of the hover labels for this
+            trace
+        bgcolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bgcolor`.
+        bordercolor
+            Sets the border color of the hover labels for this
+            trace.
+        bordercolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bordercolor`.
+        font
+            Sets the font used in hover labels.
+        namelength
+            Sets the default length (in number of characters) of
+            the trace name in the hover labels for all traces. -1
+            shows the whole name regardless of length. 0-3 shows
+            the first 0-3 characters, and an integer >3 will show
+            the whole name if it is less than that many characters,
+            but if it is longer, will truncate to `namelength - 3`
+            characters and add an ellipsis.
+        namelengthsrc
+            Sets the source reference on Chart Studio Cloud for
+            `namelength`.
+
+        Returns
+        -------
+        Hoverlabel
+        """
+        super(Hoverlabel, self).__init__("hoverlabel")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.link.Hoverlabel
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.link.Hoverlabel`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("align", None)
+        _v = align if align is not None else _v
+        if _v is not None:
+            self["align"] = _v
+        _v = arg.pop("alignsrc", None)
+        _v = alignsrc if alignsrc is not None else _v
+        if _v is not None:
+            self["alignsrc"] = _v
+        _v = arg.pop("bgcolor", None)
+        _v = bgcolor if bgcolor is not None else _v
+        if _v is not None:
+            self["bgcolor"] = _v
+        _v = arg.pop("bgcolorsrc", None)
+        _v = bgcolorsrc if bgcolorsrc is not None else _v
+        if _v is not None:
+            self["bgcolorsrc"] = _v
+        _v = arg.pop("bordercolor", None)
+        _v = bordercolor if bordercolor is not None else _v
+        if _v is not None:
+            self["bordercolor"] = _v
+        _v = arg.pop("bordercolorsrc", None)
+        _v = bordercolorsrc if bordercolorsrc is not None else _v
+        if _v is not None:
+            self["bordercolorsrc"] = _v
+        _v = arg.pop("font", None)
+        _v = font if font is not None else _v
+        if _v is not None:
+            self["font"] = _v
+        _v = arg.pop("namelength", None)
+        _v = namelength if namelength is not None else _v
+        if _v is not None:
+            self["namelength"] = _v
+        _v = arg.pop("namelengthsrc", None)
+        _v = namelengthsrc if namelengthsrc is not None else _v
+        if _v is not None:
+            self["namelengthsrc"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/link/_line.py

@@ -0,0 +1,232 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Line(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey.link"
+    _path_str = "sankey.link.line"
+    _valid_props = {"color", "colorsrc", "width", "widthsrc"}
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        Sets the color of the `line` around each `link`.
+
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # colorsrc
+    # --------
+    @property
+    def colorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `color`.
+
+        The 'colorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["colorsrc"]
+
+    @colorsrc.setter
+    def colorsrc(self, val):
+        self["colorsrc"] = val
+
+    # width
+    # -----
+    @property
+    def width(self):
+        """
+        Sets the width (in px) of the `line` around each `link`.
+
+        The 'width' property is a number and may be specified as:
+          - An int or float in the interval [0, inf]
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        int|float|numpy.ndarray
+        """
+        return self["width"]
+
+    @width.setter
+    def width(self, val):
+        self["width"] = val
+
+    # widthsrc
+    # --------
+    @property
+    def widthsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `width`.
+
+        The 'widthsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["widthsrc"]
+
+    @widthsrc.setter
+    def widthsrc(self, val):
+        self["widthsrc"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+            Sets the color of the `line` around each `link`.
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        width
+            Sets the width (in px) of the `line` around each
+            `link`.
+        widthsrc
+            Sets the source reference on Chart Studio Cloud for
+            `width`.
+        """
+
+    def __init__(
+        self, arg=None, color=None, colorsrc=None, width=None, widthsrc=None, **kwargs
+    ):
+        """
+        Construct a new Line object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.sankey.link.Line`
+        color
+            Sets the color of the `line` around each `link`.
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        width
+            Sets the width (in px) of the `line` around each
+            `link`.
+        widthsrc
+            Sets the source reference on Chart Studio Cloud for
+            `width`.
+
+        Returns
+        -------
+        Line
+        """
+        super(Line, self).__init__("line")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.link.Line
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.link.Line`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("colorsrc", None)
+        _v = colorsrc if colorsrc is not None else _v
+        if _v is not None:
+            self["colorsrc"] = _v
+        _v = arg.pop("width", None)
+        _v = width if width is not None else _v
+        if _v is not None:
+            self["width"] = _v
+        _v = arg.pop("widthsrc", None)
+        _v = widthsrc if widthsrc is not None else _v
+        if _v is not None:
+            self["widthsrc"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/link/hoverlabel/__init__.py

@@ -0,0 +1,9 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._font import Font
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(__name__, [], ["._font.Font"])

.venv/Lib/site-packages/plotly/graph_objs/sankey/link/hoverlabel/_font.py

@@ -0,0 +1,330 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Font(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey.link.hoverlabel"
+    _path_str = "sankey.link.hoverlabel.font"
+    _valid_props = {"color", "colorsrc", "family", "familysrc", "size", "sizesrc"}
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # colorsrc
+    # --------
+    @property
+    def colorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `color`.
+
+        The 'colorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["colorsrc"]
+
+    @colorsrc.setter
+    def colorsrc(self, val):
+        self["colorsrc"] = val
+
+    # family
+    # ------
+    @property
+    def family(self):
+        """
+        HTML font family - the typeface that will be applied by the web
+        browser. The web browser will only be able to apply a font if
+        it is available on the system which it operates. Provide
+        multiple font families, separated by commas, to indicate the
+        preference in which to apply fonts if they aren't available on
+        the system. The Chart Studio Cloud (at https://chart-
+        studio.plotly.com or on-premise) generates images on a server,
+        where only a select number of fonts are installed and
+        supported. These include "Arial", "Balto", "Courier New",
+        "Droid Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+        One", "Old Standard TT", "Open Sans", "Overpass", "PT Sans
+        Narrow", "Raleway", "Times New Roman".
+
+        The 'family' property is a string and must be specified as:
+          - A non-empty string
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["family"]
+
+    @family.setter
+    def family(self, val):
+        self["family"] = val
+
+    # familysrc
+    # ---------
+    @property
+    def familysrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `family`.
+
+        The 'familysrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["familysrc"]
+
+    @familysrc.setter
+    def familysrc(self, val):
+        self["familysrc"] = val
+
+    # size
+    # ----
+    @property
+    def size(self):
+        """
+        The 'size' property is a number and may be specified as:
+          - An int or float in the interval [1, inf]
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        int|float|numpy.ndarray
+        """
+        return self["size"]
+
+    @size.setter
+    def size(self, val):
+        self["size"] = val
+
+    # sizesrc
+    # -------
+    @property
+    def sizesrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `size`.
+
+        The 'sizesrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["sizesrc"]
+
+    @sizesrc.setter
+    def sizesrc(self, val):
+        self["sizesrc"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        familysrc
+            Sets the source reference on Chart Studio Cloud for
+            `family`.
+        size
+
+        sizesrc
+            Sets the source reference on Chart Studio Cloud for
+            `size`.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        color=None,
+        colorsrc=None,
+        family=None,
+        familysrc=None,
+        size=None,
+        sizesrc=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Font object
+
+        Sets the font used in hover labels.
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.sankey.link.hoverlabel.Font`
+        color
+
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        familysrc
+            Sets the source reference on Chart Studio Cloud for
+            `family`.
+        size
+
+        sizesrc
+            Sets the source reference on Chart Studio Cloud for
+            `size`.
+
+        Returns
+        -------
+        Font
+        """
+        super(Font, self).__init__("font")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.link.hoverlabel.Font
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.link.hoverlabel.Font`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("colorsrc", None)
+        _v = colorsrc if colorsrc is not None else _v
+        if _v is not None:
+            self["colorsrc"] = _v
+        _v = arg.pop("family", None)
+        _v = family if family is not None else _v
+        if _v is not None:
+            self["family"] = _v
+        _v = arg.pop("familysrc", None)
+        _v = familysrc if familysrc is not None else _v
+        if _v is not None:
+            self["familysrc"] = _v
+        _v = arg.pop("size", None)
+        _v = size if size is not None else _v
+        if _v is not None:
+            self["size"] = _v
+        _v = arg.pop("sizesrc", None)
+        _v = sizesrc if sizesrc is not None else _v
+        if _v is not None:
+            self["sizesrc"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/node/__init__.py

@@ -0,0 +1,13 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._hoverlabel import Hoverlabel
+    from ._line import Line
+    from . import hoverlabel
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(
+        __name__, [".hoverlabel"], ["._hoverlabel.Hoverlabel", "._line.Line"]
+    )

.venv/Lib/site-packages/plotly/graph_objs/sankey/node/_hoverlabel.py

@@ -0,0 +1,503 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Hoverlabel(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey.node"
+    _path_str = "sankey.node.hoverlabel"
+    _valid_props = {
+        "align",
+        "alignsrc",
+        "bgcolor",
+        "bgcolorsrc",
+        "bordercolor",
+        "bordercolorsrc",
+        "font",
+        "namelength",
+        "namelengthsrc",
+    }
+
+    # align
+    # -----
+    @property
+    def align(self):
+        """
+        Sets the horizontal alignment of the text content within hover
+        label box. Has an effect only if the hover label text spans
+        more two or more lines
+
+        The 'align' property is an enumeration that may be specified as:
+          - One of the following enumeration values:
+                ['left', 'right', 'auto']
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        Any|numpy.ndarray
+        """
+        return self["align"]
+
+    @align.setter
+    def align(self, val):
+        self["align"] = val
+
+    # alignsrc
+    # --------
+    @property
+    def alignsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `align`.
+
+        The 'alignsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["alignsrc"]
+
+    @alignsrc.setter
+    def alignsrc(self, val):
+        self["alignsrc"] = val
+
+    # bgcolor
+    # -------
+    @property
+    def bgcolor(self):
+        """
+        Sets the background color of the hover labels for this trace
+
+        The 'bgcolor' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["bgcolor"]
+
+    @bgcolor.setter
+    def bgcolor(self, val):
+        self["bgcolor"] = val
+
+    # bgcolorsrc
+    # ----------
+    @property
+    def bgcolorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `bgcolor`.
+
+        The 'bgcolorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["bgcolorsrc"]
+
+    @bgcolorsrc.setter
+    def bgcolorsrc(self, val):
+        self["bgcolorsrc"] = val
+
+    # bordercolor
+    # -----------
+    @property
+    def bordercolor(self):
+        """
+        Sets the border color of the hover labels for this trace.
+
+        The 'bordercolor' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["bordercolor"]
+
+    @bordercolor.setter
+    def bordercolor(self, val):
+        self["bordercolor"] = val
+
+    # bordercolorsrc
+    # --------------
+    @property
+    def bordercolorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `bordercolor`.
+
+        The 'bordercolorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["bordercolorsrc"]
+
+    @bordercolorsrc.setter
+    def bordercolorsrc(self, val):
+        self["bordercolorsrc"] = val
+
+    # font
+    # ----
+    @property
+    def font(self):
+        """
+        Sets the font used in hover labels.
+
+        The 'font' property is an instance of Font
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.sankey.node.hoverlabel.Font`
+          - A dict of string/value properties that will be passed
+            to the Font constructor
+
+            Supported dict properties:
+
+                color
+
+                colorsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `color`.
+                family
+                    HTML font family - the typeface that will be
+                    applied by the web browser. The web browser
+                    will only be able to apply a font if it is
+                    available on the system which it operates.
+                    Provide multiple font families, separated by
+                    commas, to indicate the preference in which to
+                    apply fonts if they aren't available on the
+                    system. The Chart Studio Cloud (at
+                    https://chart-studio.plotly.com or on-premise)
+                    generates images on a server, where only a
+                    select number of fonts are installed and
+                    supported. These include "Arial", "Balto",
+                    "Courier New", "Droid Sans",, "Droid Serif",
+                    "Droid Sans Mono", "Gravitas One", "Old
+                    Standard TT", "Open Sans", "Overpass", "PT Sans
+                    Narrow", "Raleway", "Times New Roman".
+                familysrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `family`.
+                size
+
+                sizesrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `size`.
+
+        Returns
+        -------
+        plotly.graph_objs.sankey.node.hoverlabel.Font
+        """
+        return self["font"]
+
+    @font.setter
+    def font(self, val):
+        self["font"] = val
+
+    # namelength
+    # ----------
+    @property
+    def namelength(self):
+        """
+        Sets the default length (in number of characters) of the trace
+        name in the hover labels for all traces. -1 shows the whole
+        name regardless of length. 0-3 shows the first 0-3 characters,
+        and an integer >3 will show the whole name if it is less than
+        that many characters, but if it is longer, will truncate to
+        `namelength - 3` characters and add an ellipsis.
+
+        The 'namelength' property is a integer and may be specified as:
+          - An int (or float that will be cast to an int)
+            in the interval [-1, 9223372036854775807]
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        int|numpy.ndarray
+        """
+        return self["namelength"]
+
+    @namelength.setter
+    def namelength(self, val):
+        self["namelength"] = val
+
+    # namelengthsrc
+    # -------------
+    @property
+    def namelengthsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `namelength`.
+
+        The 'namelengthsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["namelengthsrc"]
+
+    @namelengthsrc.setter
+    def namelengthsrc(self, val):
+        self["namelengthsrc"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        align
+            Sets the horizontal alignment of the text content
+            within hover label box. Has an effect only if the hover
+            label text spans more two or more lines
+        alignsrc
+            Sets the source reference on Chart Studio Cloud for
+            `align`.
+        bgcolor
+            Sets the background color of the hover labels for this
+            trace
+        bgcolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bgcolor`.
+        bordercolor
+            Sets the border color of the hover labels for this
+            trace.
+        bordercolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bordercolor`.
+        font
+            Sets the font used in hover labels.
+        namelength
+            Sets the default length (in number of characters) of
+            the trace name in the hover labels for all traces. -1
+            shows the whole name regardless of length. 0-3 shows
+            the first 0-3 characters, and an integer >3 will show
+            the whole name if it is less than that many characters,
+            but if it is longer, will truncate to `namelength - 3`
+            characters and add an ellipsis.
+        namelengthsrc
+            Sets the source reference on Chart Studio Cloud for
+            `namelength`.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        align=None,
+        alignsrc=None,
+        bgcolor=None,
+        bgcolorsrc=None,
+        bordercolor=None,
+        bordercolorsrc=None,
+        font=None,
+        namelength=None,
+        namelengthsrc=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Hoverlabel object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.sankey.node.Hoverlabel`
+        align
+            Sets the horizontal alignment of the text content
+            within hover label box. Has an effect only if the hover
+            label text spans more two or more lines
+        alignsrc
+            Sets the source reference on Chart Studio Cloud for
+            `align`.
+        bgcolor
+            Sets the background color of the hover labels for this
+            trace
+        bgcolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bgcolor`.
+        bordercolor
+            Sets the border color of the hover labels for this
+            trace.
+        bordercolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bordercolor`.
+        font
+            Sets the font used in hover labels.
+        namelength
+            Sets the default length (in number of characters) of
+            the trace name in the hover labels for all traces. -1
+            shows the whole name regardless of length. 0-3 shows
+            the first 0-3 characters, and an integer >3 will show
+            the whole name if it is less than that many characters,
+            but if it is longer, will truncate to `namelength - 3`
+            characters and add an ellipsis.
+        namelengthsrc
+            Sets the source reference on Chart Studio Cloud for
+            `namelength`.
+
+        Returns
+        -------
+        Hoverlabel
+        """
+        super(Hoverlabel, self).__init__("hoverlabel")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.node.Hoverlabel
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.node.Hoverlabel`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("align", None)
+        _v = align if align is not None else _v
+        if _v is not None:
+            self["align"] = _v
+        _v = arg.pop("alignsrc", None)
+        _v = alignsrc if alignsrc is not None else _v
+        if _v is not None:
+            self["alignsrc"] = _v
+        _v = arg.pop("bgcolor", None)
+        _v = bgcolor if bgcolor is not None else _v
+        if _v is not None:
+            self["bgcolor"] = _v
+        _v = arg.pop("bgcolorsrc", None)
+        _v = bgcolorsrc if bgcolorsrc is not None else _v
+        if _v is not None:
+            self["bgcolorsrc"] = _v
+        _v = arg.pop("bordercolor", None)
+        _v = bordercolor if bordercolor is not None else _v
+        if _v is not None:
+            self["bordercolor"] = _v
+        _v = arg.pop("bordercolorsrc", None)
+        _v = bordercolorsrc if bordercolorsrc is not None else _v
+        if _v is not None:
+            self["bordercolorsrc"] = _v
+        _v = arg.pop("font", None)
+        _v = font if font is not None else _v
+        if _v is not None:
+            self["font"] = _v
+        _v = arg.pop("namelength", None)
+        _v = namelength if namelength is not None else _v
+        if _v is not None:
+            self["namelength"] = _v
+        _v = arg.pop("namelengthsrc", None)
+        _v = namelengthsrc if namelengthsrc is not None else _v
+        if _v is not None:
+            self["namelengthsrc"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/node/_line.py

@@ -0,0 +1,232 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Line(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey.node"
+    _path_str = "sankey.node.line"
+    _valid_props = {"color", "colorsrc", "width", "widthsrc"}
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        Sets the color of the `line` around each `node`.
+
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # colorsrc
+    # --------
+    @property
+    def colorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `color`.
+
+        The 'colorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["colorsrc"]
+
+    @colorsrc.setter
+    def colorsrc(self, val):
+        self["colorsrc"] = val
+
+    # width
+    # -----
+    @property
+    def width(self):
+        """
+        Sets the width (in px) of the `line` around each `node`.
+
+        The 'width' property is a number and may be specified as:
+          - An int or float in the interval [0, inf]
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        int|float|numpy.ndarray
+        """
+        return self["width"]
+
+    @width.setter
+    def width(self, val):
+        self["width"] = val
+
+    # widthsrc
+    # --------
+    @property
+    def widthsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `width`.
+
+        The 'widthsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["widthsrc"]
+
+    @widthsrc.setter
+    def widthsrc(self, val):
+        self["widthsrc"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+            Sets the color of the `line` around each `node`.
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        width
+            Sets the width (in px) of the `line` around each
+            `node`.
+        widthsrc
+            Sets the source reference on Chart Studio Cloud for
+            `width`.
+        """
+
+    def __init__(
+        self, arg=None, color=None, colorsrc=None, width=None, widthsrc=None, **kwargs
+    ):
+        """
+        Construct a new Line object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.sankey.node.Line`
+        color
+            Sets the color of the `line` around each `node`.
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        width
+            Sets the width (in px) of the `line` around each
+            `node`.
+        widthsrc
+            Sets the source reference on Chart Studio Cloud for
+            `width`.
+
+        Returns
+        -------
+        Line
+        """
+        super(Line, self).__init__("line")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.node.Line
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.node.Line`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("colorsrc", None)
+        _v = colorsrc if colorsrc is not None else _v
+        if _v is not None:
+            self["colorsrc"] = _v
+        _v = arg.pop("width", None)
+        _v = width if width is not None else _v
+        if _v is not None:
+            self["width"] = _v
+        _v = arg.pop("widthsrc", None)
+        _v = widthsrc if widthsrc is not None else _v
+        if _v is not None:
+            self["widthsrc"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/sankey/node/hoverlabel/__init__.py

@@ -0,0 +1,9 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._font import Font
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(__name__, [], ["._font.Font"])

.venv/Lib/site-packages/plotly/graph_objs/sankey/node/hoverlabel/_font.py

@@ -0,0 +1,330 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Font(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "sankey.node.hoverlabel"
+    _path_str = "sankey.node.hoverlabel.font"
+    _valid_props = {"color", "colorsrc", "family", "familysrc", "size", "sizesrc"}
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # colorsrc
+    # --------
+    @property
+    def colorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `color`.
+
+        The 'colorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["colorsrc"]
+
+    @colorsrc.setter
+    def colorsrc(self, val):
+        self["colorsrc"] = val
+
+    # family
+    # ------
+    @property
+    def family(self):
+        """
+        HTML font family - the typeface that will be applied by the web
+        browser. The web browser will only be able to apply a font if
+        it is available on the system which it operates. Provide
+        multiple font families, separated by commas, to indicate the
+        preference in which to apply fonts if they aren't available on
+        the system. The Chart Studio Cloud (at https://chart-
+        studio.plotly.com or on-premise) generates images on a server,
+        where only a select number of fonts are installed and
+        supported. These include "Arial", "Balto", "Courier New",
+        "Droid Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+        One", "Old Standard TT", "Open Sans", "Overpass", "PT Sans
+        Narrow", "Raleway", "Times New Roman".
+
+        The 'family' property is a string and must be specified as:
+          - A non-empty string
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["family"]
+
+    @family.setter
+    def family(self, val):
+        self["family"] = val
+
+    # familysrc
+    # ---------
+    @property
+    def familysrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `family`.
+
+        The 'familysrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["familysrc"]
+
+    @familysrc.setter
+    def familysrc(self, val):
+        self["familysrc"] = val
+
+    # size
+    # ----
+    @property
+    def size(self):
+        """
+        The 'size' property is a number and may be specified as:
+          - An int or float in the interval [1, inf]
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        int|float|numpy.ndarray
+        """
+        return self["size"]
+
+    @size.setter
+    def size(self, val):
+        self["size"] = val
+
+    # sizesrc
+    # -------
+    @property
+    def sizesrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `size`.
+
+        The 'sizesrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["sizesrc"]
+
+    @sizesrc.setter
+    def sizesrc(self, val):
+        self["sizesrc"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        familysrc
+            Sets the source reference on Chart Studio Cloud for
+            `family`.
+        size
+
+        sizesrc
+            Sets the source reference on Chart Studio Cloud for
+            `size`.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        color=None,
+        colorsrc=None,
+        family=None,
+        familysrc=None,
+        size=None,
+        sizesrc=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Font object
+
+        Sets the font used in hover labels.
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.sankey.node.hoverlabel.Font`
+        color
+
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        familysrc
+            Sets the source reference on Chart Studio Cloud for
+            `family`.
+        size
+
+        sizesrc
+            Sets the source reference on Chart Studio Cloud for
+            `size`.
+
+        Returns
+        -------
+        Font
+        """
+        super(Font, self).__init__("font")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.sankey.node.hoverlabel.Font
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.sankey.node.hoverlabel.Font`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("colorsrc", None)
+        _v = colorsrc if colorsrc is not None else _v
+        if _v is not None:
+            self["colorsrc"] = _v
+        _v = arg.pop("family", None)
+        _v = family if family is not None else _v
+        if _v is not None:
+            self["family"] = _v
+        _v = arg.pop("familysrc", None)
+        _v = familysrc if familysrc is not None else _v
+        if _v is not None:
+            self["familysrc"] = _v
+        _v = arg.pop("size", None)
+        _v = size if size is not None else _v
+        if _v is not None:
+            self["size"] = _v
+        _v = arg.pop("sizesrc", None)
+        _v = sizesrc if sizesrc is not None else _v
+        if _v is not None:
+            self["sizesrc"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False