first commit

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

@@ -0,0 +1,40 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._caps import Caps
+    from ._colorbar import ColorBar
+    from ._contour import Contour
+    from ._hoverlabel import Hoverlabel
+    from ._legendgrouptitle import Legendgrouptitle
+    from ._lighting import Lighting
+    from ._lightposition import Lightposition
+    from ._slices import Slices
+    from ._spaceframe import Spaceframe
+    from ._stream import Stream
+    from ._surface import Surface
+    from . import caps
+    from . import colorbar
+    from . import hoverlabel
+    from . import legendgrouptitle
+    from . import slices
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(
+        __name__,
+        [".caps", ".colorbar", ".hoverlabel", ".legendgrouptitle", ".slices"],
+        [
+            "._caps.Caps",
+            "._colorbar.ColorBar",
+            "._contour.Contour",
+            "._hoverlabel.Hoverlabel",
+            "._legendgrouptitle.Legendgrouptitle",
+            "._lighting.Lighting",
+            "._lightposition.Lightposition",
+            "._slices.Slices",
+            "._spaceframe.Spaceframe",
+            "._stream.Stream",
+            "._surface.Surface",
+        ],
+    )

.venv/Lib/site-packages/plotly/graph_objs/volume/_caps.py

@@ -0,0 +1,211 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Caps(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume"
+    _path_str = "volume.caps"
+    _valid_props = {"x", "y", "z"}
+
+    # x
+    # -
+    @property
+    def x(self):
+        """
+        The 'x' property is an instance of X
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.volume.caps.X`
+          - A dict of string/value properties that will be passed
+            to the X constructor
+
+            Supported dict properties:
+
+                fill
+                    Sets the fill ratio of the `caps`. The default
+                    fill value of the `caps` is 1 meaning that they
+                    are entirely shaded. On the other hand Applying
+                    a `fill` ratio less than one would allow the
+                    creation of openings parallel to the edges.
+                show
+                    Sets the fill ratio of the `slices`. The
+                    default fill value of the x `slices` is 1
+                    meaning that they are entirely shaded. On the
+                    other hand Applying a `fill` ratio less than
+                    one would allow the creation of openings
+                    parallel to the edges.
+
+        Returns
+        -------
+        plotly.graph_objs.volume.caps.X
+        """
+        return self["x"]
+
+    @x.setter
+    def x(self, val):
+        self["x"] = val
+
+    # y
+    # -
+    @property
+    def y(self):
+        """
+        The 'y' property is an instance of Y
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.volume.caps.Y`
+          - A dict of string/value properties that will be passed
+            to the Y constructor
+
+            Supported dict properties:
+
+                fill
+                    Sets the fill ratio of the `caps`. The default
+                    fill value of the `caps` is 1 meaning that they
+                    are entirely shaded. On the other hand Applying
+                    a `fill` ratio less than one would allow the
+                    creation of openings parallel to the edges.
+                show
+                    Sets the fill ratio of the `slices`. The
+                    default fill value of the y `slices` is 1
+                    meaning that they are entirely shaded. On the
+                    other hand Applying a `fill` ratio less than
+                    one would allow the creation of openings
+                    parallel to the edges.
+
+        Returns
+        -------
+        plotly.graph_objs.volume.caps.Y
+        """
+        return self["y"]
+
+    @y.setter
+    def y(self, val):
+        self["y"] = val
+
+    # z
+    # -
+    @property
+    def z(self):
+        """
+        The 'z' property is an instance of Z
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.volume.caps.Z`
+          - A dict of string/value properties that will be passed
+            to the Z constructor
+
+            Supported dict properties:
+
+                fill
+                    Sets the fill ratio of the `caps`. The default
+                    fill value of the `caps` is 1 meaning that they
+                    are entirely shaded. On the other hand Applying
+                    a `fill` ratio less than one would allow the
+                    creation of openings parallel to the edges.
+                show
+                    Sets the fill ratio of the `slices`. The
+                    default fill value of the z `slices` is 1
+                    meaning that they are entirely shaded. On the
+                    other hand Applying a `fill` ratio less than
+                    one would allow the creation of openings
+                    parallel to the edges.
+
+        Returns
+        -------
+        plotly.graph_objs.volume.caps.Z
+        """
+        return self["z"]
+
+    @z.setter
+    def z(self, val):
+        self["z"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        x
+            :class:`plotly.graph_objects.volume.caps.X` instance or
+            dict with compatible properties
+        y
+            :class:`plotly.graph_objects.volume.caps.Y` instance or
+            dict with compatible properties
+        z
+            :class:`plotly.graph_objects.volume.caps.Z` instance or
+            dict with compatible properties
+        """
+
+    def __init__(self, arg=None, x=None, y=None, z=None, **kwargs):
+        """
+        Construct a new Caps object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of :class:`plotly.graph_objs.volume.Caps`
+        x
+            :class:`plotly.graph_objects.volume.caps.X` instance or
+            dict with compatible properties
+        y
+            :class:`plotly.graph_objects.volume.caps.Y` instance or
+            dict with compatible properties
+        z
+            :class:`plotly.graph_objects.volume.caps.Z` instance or
+            dict with compatible properties
+
+        Returns
+        -------
+        Caps
+        """
+        super(Caps, self).__init__("caps")
+
+        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.volume.Caps
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.Caps`"""
+            )
+
+        # 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("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
+        _v = arg.pop("z", None)
+        _v = z if z is not None else _v
+        if _v is not None:
+            self["z"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/volume/_contour.py

@@ -0,0 +1,194 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Contour(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume"
+    _path_str = "volume.contour"
+    _valid_props = {"color", "show", "width"}
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        Sets the color of the contour lines.
+
+        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
+
+    # show
+    # ----
+    @property
+    def show(self):
+        """
+        Sets whether or not dynamic contours are shown on hover
+
+        The 'show' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["show"]
+
+    @show.setter
+    def show(self, val):
+        self["show"] = val
+
+    # width
+    # -----
+    @property
+    def width(self):
+        """
+        Sets the width of the contour lines.
+
+        The 'width' property is a number and may be specified as:
+          - An int or float in the interval [1, 16]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["width"]
+
+    @width.setter
+    def width(self, val):
+        self["width"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+            Sets the color of the contour lines.
+        show
+            Sets whether or not dynamic contours are shown on hover
+        width
+            Sets the width of the contour lines.
+        """
+
+    def __init__(self, arg=None, color=None, show=None, width=None, **kwargs):
+        """
+        Construct a new Contour object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.volume.Contour`
+        color
+            Sets the color of the contour lines.
+        show
+            Sets whether or not dynamic contours are shown on hover
+        width
+            Sets the width of the contour lines.
+
+        Returns
+        -------
+        Contour
+        """
+        super(Contour, self).__init__("contour")
+
+        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.volume.Contour
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.Contour`"""
+            )
+
+        # 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("show", None)
+        _v = show if show is not None else _v
+        if _v is not None:
+            self["show"] = _v
+        _v = arg.pop("width", None)
+        _v = width if width is not None else _v
+        if _v is not None:
+            self["width"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/volume/_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 = "volume"
+    _path_str = "volume.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.volume.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.volume.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.volume.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.volume.Hoverlabel
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.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/volume/_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 = "volume"
+    _path_str = "volume.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.volume.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.volume.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.volume.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.volume.Legendgrouptitle
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.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/volume/_lighting.py

@@ -0,0 +1,312 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Lighting(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume"
+    _path_str = "volume.lighting"
+    _valid_props = {
+        "ambient",
+        "diffuse",
+        "facenormalsepsilon",
+        "fresnel",
+        "roughness",
+        "specular",
+        "vertexnormalsepsilon",
+    }
+
+    # ambient
+    # -------
+    @property
+    def ambient(self):
+        """
+        Ambient light increases overall color visibility but can wash
+        out the image.
+
+        The 'ambient' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["ambient"]
+
+    @ambient.setter
+    def ambient(self, val):
+        self["ambient"] = val
+
+    # diffuse
+    # -------
+    @property
+    def diffuse(self):
+        """
+        Represents the extent that incident rays are reflected in a
+        range of angles.
+
+        The 'diffuse' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["diffuse"]
+
+    @diffuse.setter
+    def diffuse(self, val):
+        self["diffuse"] = val
+
+    # facenormalsepsilon
+    # ------------------
+    @property
+    def facenormalsepsilon(self):
+        """
+        Epsilon for face normals calculation avoids math issues arising
+        from degenerate geometry.
+
+        The 'facenormalsepsilon' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["facenormalsepsilon"]
+
+    @facenormalsepsilon.setter
+    def facenormalsepsilon(self, val):
+        self["facenormalsepsilon"] = val
+
+    # fresnel
+    # -------
+    @property
+    def fresnel(self):
+        """
+        Represents the reflectance as a dependency of the viewing
+        angle; e.g. paper is reflective when viewing it from the edge
+        of the paper (almost 90 degrees), causing shine.
+
+        The 'fresnel' property is a number and may be specified as:
+          - An int or float in the interval [0, 5]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["fresnel"]
+
+    @fresnel.setter
+    def fresnel(self, val):
+        self["fresnel"] = val
+
+    # roughness
+    # ---------
+    @property
+    def roughness(self):
+        """
+        Alters specular reflection; the rougher the surface, the wider
+        and less contrasty the shine.
+
+        The 'roughness' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["roughness"]
+
+    @roughness.setter
+    def roughness(self, val):
+        self["roughness"] = val
+
+    # specular
+    # --------
+    @property
+    def specular(self):
+        """
+        Represents the level that incident rays are reflected in a
+        single direction, causing shine.
+
+        The 'specular' property is a number and may be specified as:
+          - An int or float in the interval [0, 2]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["specular"]
+
+    @specular.setter
+    def specular(self, val):
+        self["specular"] = val
+
+    # vertexnormalsepsilon
+    # --------------------
+    @property
+    def vertexnormalsepsilon(self):
+        """
+        Epsilon for vertex normals calculation avoids math issues
+        arising from degenerate geometry.
+
+        The 'vertexnormalsepsilon' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["vertexnormalsepsilon"]
+
+    @vertexnormalsepsilon.setter
+    def vertexnormalsepsilon(self, val):
+        self["vertexnormalsepsilon"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        ambient
+            Ambient light increases overall color visibility but
+            can wash out the image.
+        diffuse
+            Represents the extent that incident rays are reflected
+            in a range of angles.
+        facenormalsepsilon
+            Epsilon for face normals calculation avoids math issues
+            arising from degenerate geometry.
+        fresnel
+            Represents the reflectance as a dependency of the
+            viewing angle; e.g. paper is reflective when viewing it
+            from the edge of the paper (almost 90 degrees), causing
+            shine.
+        roughness
+            Alters specular reflection; the rougher the surface,
+            the wider and less contrasty the shine.
+        specular
+            Represents the level that incident rays are reflected
+            in a single direction, causing shine.
+        vertexnormalsepsilon
+            Epsilon for vertex normals calculation avoids math
+            issues arising from degenerate geometry.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        ambient=None,
+        diffuse=None,
+        facenormalsepsilon=None,
+        fresnel=None,
+        roughness=None,
+        specular=None,
+        vertexnormalsepsilon=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Lighting object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.volume.Lighting`
+        ambient
+            Ambient light increases overall color visibility but
+            can wash out the image.
+        diffuse
+            Represents the extent that incident rays are reflected
+            in a range of angles.
+        facenormalsepsilon
+            Epsilon for face normals calculation avoids math issues
+            arising from degenerate geometry.
+        fresnel
+            Represents the reflectance as a dependency of the
+            viewing angle; e.g. paper is reflective when viewing it
+            from the edge of the paper (almost 90 degrees), causing
+            shine.
+        roughness
+            Alters specular reflection; the rougher the surface,
+            the wider and less contrasty the shine.
+        specular
+            Represents the level that incident rays are reflected
+            in a single direction, causing shine.
+        vertexnormalsepsilon
+            Epsilon for vertex normals calculation avoids math
+            issues arising from degenerate geometry.
+
+        Returns
+        -------
+        Lighting
+        """
+        super(Lighting, self).__init__("lighting")
+
+        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.volume.Lighting
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.Lighting`"""
+            )
+
+        # 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("ambient", None)
+        _v = ambient if ambient is not None else _v
+        if _v is not None:
+            self["ambient"] = _v
+        _v = arg.pop("diffuse", None)
+        _v = diffuse if diffuse is not None else _v
+        if _v is not None:
+            self["diffuse"] = _v
+        _v = arg.pop("facenormalsepsilon", None)
+        _v = facenormalsepsilon if facenormalsepsilon is not None else _v
+        if _v is not None:
+            self["facenormalsepsilon"] = _v
+        _v = arg.pop("fresnel", None)
+        _v = fresnel if fresnel is not None else _v
+        if _v is not None:
+            self["fresnel"] = _v
+        _v = arg.pop("roughness", None)
+        _v = roughness if roughness is not None else _v
+        if _v is not None:
+            self["roughness"] = _v
+        _v = arg.pop("specular", None)
+        _v = specular if specular is not None else _v
+        if _v is not None:
+            self["specular"] = _v
+        _v = arg.pop("vertexnormalsepsilon", None)
+        _v = vertexnormalsepsilon if vertexnormalsepsilon is not None else _v
+        if _v is not None:
+            self["vertexnormalsepsilon"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/volume/_lightposition.py

@@ -0,0 +1,161 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Lightposition(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume"
+    _path_str = "volume.lightposition"
+    _valid_props = {"x", "y", "z"}
+
+    # x
+    # -
+    @property
+    def x(self):
+        """
+        Numeric vector, representing the X coordinate for each vertex.
+
+        The 'x' property is a number and may be specified as:
+          - An int or float in the interval [-100000, 100000]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["x"]
+
+    @x.setter
+    def x(self, val):
+        self["x"] = val
+
+    # y
+    # -
+    @property
+    def y(self):
+        """
+        Numeric vector, representing the Y coordinate for each vertex.
+
+        The 'y' property is a number and may be specified as:
+          - An int or float in the interval [-100000, 100000]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["y"]
+
+    @y.setter
+    def y(self, val):
+        self["y"] = val
+
+    # z
+    # -
+    @property
+    def z(self):
+        """
+        Numeric vector, representing the Z coordinate for each vertex.
+
+        The 'z' property is a number and may be specified as:
+          - An int or float in the interval [-100000, 100000]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["z"]
+
+    @z.setter
+    def z(self, val):
+        self["z"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        x
+            Numeric vector, representing the X coordinate for each
+            vertex.
+        y
+            Numeric vector, representing the Y coordinate for each
+            vertex.
+        z
+            Numeric vector, representing the Z coordinate for each
+            vertex.
+        """
+
+    def __init__(self, arg=None, x=None, y=None, z=None, **kwargs):
+        """
+        Construct a new Lightposition object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.volume.Lightposition`
+        x
+            Numeric vector, representing the X coordinate for each
+            vertex.
+        y
+            Numeric vector, representing the Y coordinate for each
+            vertex.
+        z
+            Numeric vector, representing the Z coordinate for each
+            vertex.
+
+        Returns
+        -------
+        Lightposition
+        """
+        super(Lightposition, self).__init__("lightposition")
+
+        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.volume.Lightposition
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.Lightposition`"""
+            )
+
+        # 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("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
+        _v = arg.pop("z", None)
+        _v = z if z is not None else _v
+        if _v is not None:
+            self["z"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/volume/_slices.py

@@ -0,0 +1,226 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Slices(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume"
+    _path_str = "volume.slices"
+    _valid_props = {"x", "y", "z"}
+
+    # x
+    # -
+    @property
+    def x(self):
+        """
+        The 'x' property is an instance of X
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.volume.slices.X`
+          - A dict of string/value properties that will be passed
+            to the X constructor
+
+            Supported dict properties:
+
+                fill
+                    Sets the fill ratio of the `slices`. The
+                    default fill value of the `slices` is 1 meaning
+                    that they are entirely shaded. On the other
+                    hand Applying a `fill` ratio less than one
+                    would allow the creation of openings parallel
+                    to the edges.
+                locations
+                    Specifies the location(s) of slices on the
+                    axis. When not specified slices would be
+                    created for all points of the axis x except
+                    start and end.
+                locationssrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `locations`.
+                show
+                    Determines whether or not slice planes about
+                    the x dimension are drawn.
+
+        Returns
+        -------
+        plotly.graph_objs.volume.slices.X
+        """
+        return self["x"]
+
+    @x.setter
+    def x(self, val):
+        self["x"] = val
+
+    # y
+    # -
+    @property
+    def y(self):
+        """
+        The 'y' property is an instance of Y
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.volume.slices.Y`
+          - A dict of string/value properties that will be passed
+            to the Y constructor
+
+            Supported dict properties:
+
+                fill
+                    Sets the fill ratio of the `slices`. The
+                    default fill value of the `slices` is 1 meaning
+                    that they are entirely shaded. On the other
+                    hand Applying a `fill` ratio less than one
+                    would allow the creation of openings parallel
+                    to the edges.
+                locations
+                    Specifies the location(s) of slices on the
+                    axis. When not specified slices would be
+                    created for all points of the axis y except
+                    start and end.
+                locationssrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `locations`.
+                show
+                    Determines whether or not slice planes about
+                    the y dimension are drawn.
+
+        Returns
+        -------
+        plotly.graph_objs.volume.slices.Y
+        """
+        return self["y"]
+
+    @y.setter
+    def y(self, val):
+        self["y"] = val
+
+    # z
+    # -
+    @property
+    def z(self):
+        """
+        The 'z' property is an instance of Z
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.volume.slices.Z`
+          - A dict of string/value properties that will be passed
+            to the Z constructor
+
+            Supported dict properties:
+
+                fill
+                    Sets the fill ratio of the `slices`. The
+                    default fill value of the `slices` is 1 meaning
+                    that they are entirely shaded. On the other
+                    hand Applying a `fill` ratio less than one
+                    would allow the creation of openings parallel
+                    to the edges.
+                locations
+                    Specifies the location(s) of slices on the
+                    axis. When not specified slices would be
+                    created for all points of the axis z except
+                    start and end.
+                locationssrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `locations`.
+                show
+                    Determines whether or not slice planes about
+                    the z dimension are drawn.
+
+        Returns
+        -------
+        plotly.graph_objs.volume.slices.Z
+        """
+        return self["z"]
+
+    @z.setter
+    def z(self, val):
+        self["z"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        x
+            :class:`plotly.graph_objects.volume.slices.X` instance
+            or dict with compatible properties
+        y
+            :class:`plotly.graph_objects.volume.slices.Y` instance
+            or dict with compatible properties
+        z
+            :class:`plotly.graph_objects.volume.slices.Z` instance
+            or dict with compatible properties
+        """
+
+    def __init__(self, arg=None, x=None, y=None, z=None, **kwargs):
+        """
+        Construct a new Slices object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of :class:`plotly.graph_objs.volume.Slices`
+        x
+            :class:`plotly.graph_objects.volume.slices.X` instance
+            or dict with compatible properties
+        y
+            :class:`plotly.graph_objects.volume.slices.Y` instance
+            or dict with compatible properties
+        z
+            :class:`plotly.graph_objects.volume.slices.Z` instance
+            or dict with compatible properties
+
+        Returns
+        -------
+        Slices
+        """
+        super(Slices, self).__init__("slices")
+
+        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.volume.Slices
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.Slices`"""
+            )
+
+        # 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("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
+        _v = arg.pop("z", None)
+        _v = z if z is not None else _v
+        if _v is not None:
+            self["z"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/volume/_spaceframe.py

@@ -0,0 +1,144 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Spaceframe(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume"
+    _path_str = "volume.spaceframe"
+    _valid_props = {"fill", "show"}
+
+    # fill
+    # ----
+    @property
+    def fill(self):
+        """
+        Sets the fill ratio of the `spaceframe` elements. The default
+        fill value is 1 meaning that they are entirely shaded. Applying
+        a `fill` ratio less than one would allow the creation of
+        openings parallel to the edges.
+
+        The 'fill' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["fill"]
+
+    @fill.setter
+    def fill(self, val):
+        self["fill"] = val
+
+    # show
+    # ----
+    @property
+    def show(self):
+        """
+        Displays/hides tetrahedron shapes between minimum and maximum
+        iso-values. Often useful when either caps or surfaces are
+        disabled or filled with values less than 1.
+
+        The 'show' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["show"]
+
+    @show.setter
+    def show(self, val):
+        self["show"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        fill
+            Sets the fill ratio of the `spaceframe` elements. The
+            default fill value is 1 meaning that they are entirely
+            shaded. Applying a `fill` ratio less than one would
+            allow the creation of openings parallel to the edges.
+        show
+            Displays/hides tetrahedron shapes between minimum and
+            maximum iso-values. Often useful when either caps or
+            surfaces are disabled or filled with values less than
+            1.
+        """
+
+    def __init__(self, arg=None, fill=None, show=None, **kwargs):
+        """
+        Construct a new Spaceframe object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.volume.Spaceframe`
+        fill
+            Sets the fill ratio of the `spaceframe` elements. The
+            default fill value is 1 meaning that they are entirely
+            shaded. Applying a `fill` ratio less than one would
+            allow the creation of openings parallel to the edges.
+        show
+            Displays/hides tetrahedron shapes between minimum and
+            maximum iso-values. Often useful when either caps or
+            surfaces are disabled or filled with values less than
+            1.
+
+        Returns
+        -------
+        Spaceframe
+        """
+        super(Spaceframe, self).__init__("spaceframe")
+
+        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.volume.Spaceframe
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.Spaceframe`"""
+            )
+
+        # 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("fill", None)
+        _v = fill if fill is not None else _v
+        if _v is not None:
+            self["fill"] = _v
+        _v = arg.pop("show", None)
+        _v = show if show is not None else _v
+        if _v is not None:
+            self["show"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/volume/_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 = "volume"
+    _path_str = "volume.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.volume.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.volume.Stream
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.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/volume/_surface.py

@@ -0,0 +1,230 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Surface(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume"
+    _path_str = "volume.surface"
+    _valid_props = {"count", "fill", "pattern", "show"}
+
+    # count
+    # -----
+    @property
+    def count(self):
+        """
+        Sets the number of iso-surfaces between minimum and maximum
+        iso-values. By default this value is 2 meaning that only
+        minimum and maximum surfaces would be drawn.
+
+        The 'count' 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]
+
+        Returns
+        -------
+        int
+        """
+        return self["count"]
+
+    @count.setter
+    def count(self, val):
+        self["count"] = val
+
+    # fill
+    # ----
+    @property
+    def fill(self):
+        """
+        Sets the fill ratio of the iso-surface. The default fill value
+        of the surface is 1 meaning that they are entirely shaded. On
+        the other hand Applying a `fill` ratio less than one would
+        allow the creation of openings parallel to the edges.
+
+        The 'fill' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["fill"]
+
+    @fill.setter
+    def fill(self, val):
+        self["fill"] = val
+
+    # pattern
+    # -------
+    @property
+    def pattern(self):
+        """
+        Sets the surface pattern of the iso-surface 3-D sections. The
+        default pattern of the surface is `all` meaning that the rest
+        of surface elements would be shaded. The check options (either
+        1 or 2) could be used to draw half of the squares on the
+        surface. Using various combinations of capital `A`, `B`, `C`,
+        `D` and `E` may also be used to reduce the number of triangles
+        on the iso-surfaces and creating other patterns of interest.
+
+        The 'pattern' property is a flaglist and may be specified
+        as a string containing:
+          - Any combination of ['A', 'B', 'C', 'D', 'E'] joined with '+' characters
+            (e.g. 'A+B')
+            OR exactly one of ['all', 'odd', 'even'] (e.g. 'even')
+
+        Returns
+        -------
+        Any
+        """
+        return self["pattern"]
+
+    @pattern.setter
+    def pattern(self, val):
+        self["pattern"] = val
+
+    # show
+    # ----
+    @property
+    def show(self):
+        """
+        Hides/displays surfaces between minimum and maximum iso-values.
+
+        The 'show' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["show"]
+
+    @show.setter
+    def show(self, val):
+        self["show"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        count
+            Sets the number of iso-surfaces between minimum and
+            maximum iso-values. By default this value is 2 meaning
+            that only minimum and maximum surfaces would be drawn.
+        fill
+            Sets the fill ratio of the iso-surface. The default
+            fill value of the surface is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+        pattern
+            Sets the surface pattern of the iso-surface 3-D
+            sections. The default pattern of the surface is `all`
+            meaning that the rest of surface elements would be
+            shaded. The check options (either 1 or 2) could be used
+            to draw half of the squares on the surface. Using
+            various combinations of capital `A`, `B`, `C`, `D` and
+            `E` may also be used to reduce the number of triangles
+            on the iso-surfaces and creating other patterns of
+            interest.
+        show
+            Hides/displays surfaces between minimum and maximum
+            iso-values.
+        """
+
+    def __init__(
+        self, arg=None, count=None, fill=None, pattern=None, show=None, **kwargs
+    ):
+        """
+        Construct a new Surface object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.volume.Surface`
+        count
+            Sets the number of iso-surfaces between minimum and
+            maximum iso-values. By default this value is 2 meaning
+            that only minimum and maximum surfaces would be drawn.
+        fill
+            Sets the fill ratio of the iso-surface. The default
+            fill value of the surface is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+        pattern
+            Sets the surface pattern of the iso-surface 3-D
+            sections. The default pattern of the surface is `all`
+            meaning that the rest of surface elements would be
+            shaded. The check options (either 1 or 2) could be used
+            to draw half of the squares on the surface. Using
+            various combinations of capital `A`, `B`, `C`, `D` and
+            `E` may also be used to reduce the number of triangles
+            on the iso-surfaces and creating other patterns of
+            interest.
+        show
+            Hides/displays surfaces between minimum and maximum
+            iso-values.
+
+        Returns
+        -------
+        Surface
+        """
+        super(Surface, self).__init__("surface")
+
+        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.volume.Surface
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.Surface`"""
+            )
+
+        # 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("count", None)
+        _v = count if count is not None else _v
+        if _v is not None:
+            self["count"] = _v
+        _v = arg.pop("fill", None)
+        _v = fill if fill is not None else _v
+        if _v is not None:
+            self["fill"] = _v
+        _v = arg.pop("pattern", None)
+        _v = pattern if pattern is not None else _v
+        if _v is not None:
+            self["pattern"] = _v
+        _v = arg.pop("show", None)
+        _v = show if show is not None else _v
+        if _v is not None:
+            self["show"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/volume/caps/__init__.py

@@ -0,0 +1,13 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._x import X
+    from ._y import Y
+    from ._z import Z
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(
+        __name__, [], ["._x.X", "._y.Y", "._z.Z"]
+    )

.venv/Lib/site-packages/plotly/graph_objs/volume/caps/_x.py

@@ -0,0 +1,148 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class X(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume.caps"
+    _path_str = "volume.caps.x"
+    _valid_props = {"fill", "show"}
+
+    # fill
+    # ----
+    @property
+    def fill(self):
+        """
+        Sets the fill ratio of the `caps`. The default fill value of
+        the `caps` is 1 meaning that they are entirely shaded. On the
+        other hand Applying a `fill` ratio less than one would allow
+        the creation of openings parallel to the edges.
+
+        The 'fill' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["fill"]
+
+    @fill.setter
+    def fill(self, val):
+        self["fill"] = val
+
+    # show
+    # ----
+    @property
+    def show(self):
+        """
+        Sets the fill ratio of the `slices`. The default fill value of
+        the x `slices` is 1 meaning that they are entirely shaded. On
+        the other hand Applying a `fill` ratio less than one would
+        allow the creation of openings parallel to the edges.
+
+        The 'show' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["show"]
+
+    @show.setter
+    def show(self, val):
+        self["show"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        fill
+            Sets the fill ratio of the `caps`. The default fill
+            value of the `caps` is 1 meaning that they are entirely
+            shaded. On the other hand Applying a `fill` ratio less
+            than one would allow the creation of openings parallel
+            to the edges.
+        show
+            Sets the fill ratio of the `slices`. The default fill
+            value of the x `slices` is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+        """
+
+    def __init__(self, arg=None, fill=None, show=None, **kwargs):
+        """
+        Construct a new X object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of :class:`plotly.graph_objs.volume.caps.X`
+        fill
+            Sets the fill ratio of the `caps`. The default fill
+            value of the `caps` is 1 meaning that they are entirely
+            shaded. On the other hand Applying a `fill` ratio less
+            than one would allow the creation of openings parallel
+            to the edges.
+        show
+            Sets the fill ratio of the `slices`. The default fill
+            value of the x `slices` is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+
+        Returns
+        -------
+        X
+        """
+        super(X, self).__init__("x")
+
+        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.volume.caps.X
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.caps.X`"""
+            )
+
+        # 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("fill", None)
+        _v = fill if fill is not None else _v
+        if _v is not None:
+            self["fill"] = _v
+        _v = arg.pop("show", None)
+        _v = show if show is not None else _v
+        if _v is not None:
+            self["show"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/volume/caps/_y.py

@@ -0,0 +1,148 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Y(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume.caps"
+    _path_str = "volume.caps.y"
+    _valid_props = {"fill", "show"}
+
+    # fill
+    # ----
+    @property
+    def fill(self):
+        """
+        Sets the fill ratio of the `caps`. The default fill value of
+        the `caps` is 1 meaning that they are entirely shaded. On the
+        other hand Applying a `fill` ratio less than one would allow
+        the creation of openings parallel to the edges.
+
+        The 'fill' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["fill"]
+
+    @fill.setter
+    def fill(self, val):
+        self["fill"] = val
+
+    # show
+    # ----
+    @property
+    def show(self):
+        """
+        Sets the fill ratio of the `slices`. The default fill value of
+        the y `slices` is 1 meaning that they are entirely shaded. On
+        the other hand Applying a `fill` ratio less than one would
+        allow the creation of openings parallel to the edges.
+
+        The 'show' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["show"]
+
+    @show.setter
+    def show(self, val):
+        self["show"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        fill
+            Sets the fill ratio of the `caps`. The default fill
+            value of the `caps` is 1 meaning that they are entirely
+            shaded. On the other hand Applying a `fill` ratio less
+            than one would allow the creation of openings parallel
+            to the edges.
+        show
+            Sets the fill ratio of the `slices`. The default fill
+            value of the y `slices` is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+        """
+
+    def __init__(self, arg=None, fill=None, show=None, **kwargs):
+        """
+        Construct a new Y object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of :class:`plotly.graph_objs.volume.caps.Y`
+        fill
+            Sets the fill ratio of the `caps`. The default fill
+            value of the `caps` is 1 meaning that they are entirely
+            shaded. On the other hand Applying a `fill` ratio less
+            than one would allow the creation of openings parallel
+            to the edges.
+        show
+            Sets the fill ratio of the `slices`. The default fill
+            value of the y `slices` is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+
+        Returns
+        -------
+        Y
+        """
+        super(Y, self).__init__("y")
+
+        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.volume.caps.Y
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.caps.Y`"""
+            )
+
+        # 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("fill", None)
+        _v = fill if fill is not None else _v
+        if _v is not None:
+            self["fill"] = _v
+        _v = arg.pop("show", None)
+        _v = show if show is not None else _v
+        if _v is not None:
+            self["show"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/volume/caps/_z.py

@@ -0,0 +1,148 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Z(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume.caps"
+    _path_str = "volume.caps.z"
+    _valid_props = {"fill", "show"}
+
+    # fill
+    # ----
+    @property
+    def fill(self):
+        """
+        Sets the fill ratio of the `caps`. The default fill value of
+        the `caps` is 1 meaning that they are entirely shaded. On the
+        other hand Applying a `fill` ratio less than one would allow
+        the creation of openings parallel to the edges.
+
+        The 'fill' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["fill"]
+
+    @fill.setter
+    def fill(self, val):
+        self["fill"] = val
+
+    # show
+    # ----
+    @property
+    def show(self):
+        """
+        Sets the fill ratio of the `slices`. The default fill value of
+        the z `slices` is 1 meaning that they are entirely shaded. On
+        the other hand Applying a `fill` ratio less than one would
+        allow the creation of openings parallel to the edges.
+
+        The 'show' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["show"]
+
+    @show.setter
+    def show(self, val):
+        self["show"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        fill
+            Sets the fill ratio of the `caps`. The default fill
+            value of the `caps` is 1 meaning that they are entirely
+            shaded. On the other hand Applying a `fill` ratio less
+            than one would allow the creation of openings parallel
+            to the edges.
+        show
+            Sets the fill ratio of the `slices`. The default fill
+            value of the z `slices` is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+        """
+
+    def __init__(self, arg=None, fill=None, show=None, **kwargs):
+        """
+        Construct a new Z object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of :class:`plotly.graph_objs.volume.caps.Z`
+        fill
+            Sets the fill ratio of the `caps`. The default fill
+            value of the `caps` is 1 meaning that they are entirely
+            shaded. On the other hand Applying a `fill` ratio less
+            than one would allow the creation of openings parallel
+            to the edges.
+        show
+            Sets the fill ratio of the `slices`. The default fill
+            value of the z `slices` is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+
+        Returns
+        -------
+        Z
+        """
+        super(Z, self).__init__("z")
+
+        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.volume.caps.Z
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.caps.Z`"""
+            )
+
+        # 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("fill", None)
+        _v = fill if fill is not None else _v
+        if _v is not None:
+            self["fill"] = _v
+        _v = arg.pop("show", None)
+        _v = show if show is not None else _v
+        if _v is not None:
+            self["show"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/volume/colorbar/__init__.py

@@ -0,0 +1,16 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._tickfont import Tickfont
+    from ._tickformatstop import Tickformatstop
+    from ._title import Title
+    from . import title
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(
+        __name__,
+        [".title"],
+        ["._tickfont.Tickfont", "._tickformatstop.Tickformatstop", "._title.Title"],
+    )

.venv/Lib/site-packages/plotly/graph_objs/volume/colorbar/_tickfont.py

@@ -0,0 +1,227 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Tickfont(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume.colorbar"
+    _path_str = "volume.colorbar.tickfont"
+    _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 Tickfont object
+
+        Sets the color bar's tick label font
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.volume.colorbar.Tickfont`
+        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
+        -------
+        Tickfont
+        """
+        super(Tickfont, self).__init__("tickfont")
+
+        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.volume.colorbar.Tickfont
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.colorbar.Tickfont`"""
+            )
+
+        # 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/volume/colorbar/_tickformatstop.py

@@ -0,0 +1,283 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Tickformatstop(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume.colorbar"
+    _path_str = "volume.colorbar.tickformatstop"
+    _valid_props = {"dtickrange", "enabled", "name", "templateitemname", "value"}
+
+    # dtickrange
+    # ----------
+    @property
+    def dtickrange(self):
+        """
+            range [*min*, *max*], where "min", "max" - dtick values which
+            describe some zoom level, it is possible to omit "min" or "max"
+            value by passing "null"
+
+            The 'dtickrange' property is an info array that may be specified as:
+
+            * a list or tuple of 2 elements where:
+        (0) The 'dtickrange[0]' property accepts values of any type
+        (1) The 'dtickrange[1]' property accepts values of any type
+
+            Returns
+            -------
+            list
+        """
+        return self["dtickrange"]
+
+    @dtickrange.setter
+    def dtickrange(self, val):
+        self["dtickrange"] = val
+
+    # enabled
+    # -------
+    @property
+    def enabled(self):
+        """
+        Determines whether or not this stop is used. If `false`, this
+        stop is ignored even within its `dtickrange`.
+
+        The 'enabled' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["enabled"]
+
+    @enabled.setter
+    def enabled(self, val):
+        self["enabled"] = 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
+
+    # value
+    # -----
+    @property
+    def value(self):
+        """
+        string - dtickformat for described zoom level, the same as
+        "tickformat"
+
+        The 'value' property is a string and must be specified as:
+          - A string
+          - A number that will be converted to a string
+
+        Returns
+        -------
+        str
+        """
+        return self["value"]
+
+    @value.setter
+    def value(self, val):
+        self["value"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        dtickrange
+            range [*min*, *max*], where "min", "max" - dtick values
+            which describe some zoom level, it is possible to omit
+            "min" or "max" value by passing "null"
+        enabled
+            Determines whether or not this stop is used. If
+            `false`, this stop is ignored even within its
+            `dtickrange`.
+        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`.
+        value
+            string - dtickformat for described zoom level, the same
+            as "tickformat"
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        dtickrange=None,
+        enabled=None,
+        name=None,
+        templateitemname=None,
+        value=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Tickformatstop object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of :class:`plotly.graph_objs.volume.colorba
+            r.Tickformatstop`
+        dtickrange
+            range [*min*, *max*], where "min", "max" - dtick values
+            which describe some zoom level, it is possible to omit
+            "min" or "max" value by passing "null"
+        enabled
+            Determines whether or not this stop is used. If
+            `false`, this stop is ignored even within its
+            `dtickrange`.
+        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`.
+        value
+            string - dtickformat for described zoom level, the same
+            as "tickformat"
+
+        Returns
+        -------
+        Tickformatstop
+        """
+        super(Tickformatstop, self).__init__("tickformatstops")
+
+        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.volume.colorbar.Tickformatstop
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.colorbar.Tickformatstop`"""
+            )
+
+        # 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("dtickrange", None)
+        _v = dtickrange if dtickrange is not None else _v
+        if _v is not None:
+            self["dtickrange"] = _v
+        _v = arg.pop("enabled", None)
+        _v = enabled if enabled is not None else _v
+        if _v is not None:
+            self["enabled"] = _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
+        _v = arg.pop("value", None)
+        _v = value if value is not None else _v
+        if _v is not None:
+            self["value"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/volume/colorbar/_title.py

@@ -0,0 +1,210 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Title(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume.colorbar"
+    _path_str = "volume.colorbar.title"
+    _valid_props = {"font", "side", "text"}
+
+    # font
+    # ----
+    @property
+    def font(self):
+        """
+        Sets this color bar's title font. Note that the title's font
+        used to be set by the now deprecated `titlefont` attribute.
+
+        The 'font' property is an instance of Font
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.volume.colorbar.title.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.volume.colorbar.title.Font
+        """
+        return self["font"]
+
+    @font.setter
+    def font(self, val):
+        self["font"] = val
+
+    # side
+    # ----
+    @property
+    def side(self):
+        """
+        Determines the location of color bar's title with respect to
+        the color bar. Defaults to "top" when `orientation` if "v" and
+        defaults to "right" when `orientation` if "h". Note that the
+        title's location used to be set by the now deprecated
+        `titleside` attribute.
+
+        The 'side' property is an enumeration that may be specified as:
+          - One of the following enumeration values:
+                ['right', 'top', 'bottom']
+
+        Returns
+        -------
+        Any
+        """
+        return self["side"]
+
+    @side.setter
+    def side(self, val):
+        self["side"] = val
+
+    # text
+    # ----
+    @property
+    def text(self):
+        """
+        Sets the title of the color bar. Note that before the existence
+        of `title.text`, the title's contents used to be defined as the
+        `title` attribute itself. This behavior has been deprecated.
+
+        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 color bar's title font. Note that the title's
+            font used to be set by the now deprecated `titlefont`
+            attribute.
+        side
+            Determines the location of color bar's title with
+            respect to the color bar. Defaults to "top" when
+            `orientation` if "v" and  defaults to "right" when
+            `orientation` if "h". Note that the title's location
+            used to be set by the now deprecated `titleside`
+            attribute.
+        text
+            Sets the title of the color bar. Note that before the
+            existence of `title.text`, the title's contents used to
+            be defined as the `title` attribute itself. This
+            behavior has been deprecated.
+        """
+
+    def __init__(self, arg=None, font=None, side=None, text=None, **kwargs):
+        """
+        Construct a new Title object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.volume.colorbar.Title`
+        font
+            Sets this color bar's title font. Note that the title's
+            font used to be set by the now deprecated `titlefont`
+            attribute.
+        side
+            Determines the location of color bar's title with
+            respect to the color bar. Defaults to "top" when
+            `orientation` if "v" and  defaults to "right" when
+            `orientation` if "h". Note that the title's location
+            used to be set by the now deprecated `titleside`
+            attribute.
+        text
+            Sets the title of the color bar. Note that before the
+            existence of `title.text`, the title's contents used to
+            be defined as the `title` attribute itself. This
+            behavior has been deprecated.
+
+        Returns
+        -------
+        Title
+        """
+        super(Title, self).__init__("title")
+
+        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.volume.colorbar.Title
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.colorbar.Title`"""
+            )
+
+        # 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("side", None)
+        _v = side if side is not None else _v
+        if _v is not None:
+            self["side"] = _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/volume/colorbar/title/__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/volume/colorbar/title/_font.py

@@ -0,0 +1,228 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Font(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume.colorbar.title"
+    _path_str = "volume.colorbar.title.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 color bar's title font. Note that the title's font
+        used to be set by the now deprecated `titlefont` attribute.
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.volume.colorbar.title.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.volume.colorbar.title.Font
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.colorbar.title.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/volume/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/volume/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 = "volume.hoverlabel"
+    _path_str = "volume.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.volume.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.volume.hoverlabel.Font
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.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/volume/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/volume/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 = "volume.legendgrouptitle"
+    _path_str = "volume.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.volume.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.volume.legendgrouptitle.Font
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.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/volume/slices/__init__.py

@@ -0,0 +1,13 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._x import X
+    from ._y import Y
+    from ._z import Z
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(
+        __name__, [], ["._x.X", "._y.Y", "._z.Z"]
+    )

.venv/Lib/site-packages/plotly/graph_objs/volume/slices/_x.py

@@ -0,0 +1,214 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class X(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume.slices"
+    _path_str = "volume.slices.x"
+    _valid_props = {"fill", "locations", "locationssrc", "show"}
+
+    # fill
+    # ----
+    @property
+    def fill(self):
+        """
+        Sets the fill ratio of the `slices`. The default fill value of
+        the `slices` is 1 meaning that they are entirely shaded. On the
+        other hand Applying a `fill` ratio less than one would allow
+        the creation of openings parallel to the edges.
+
+        The 'fill' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["fill"]
+
+    @fill.setter
+    def fill(self, val):
+        self["fill"] = val
+
+    # locations
+    # ---------
+    @property
+    def locations(self):
+        """
+        Specifies the location(s) of slices on the axis. When not
+        specified slices would be created for all points of the axis x
+        except start and end.
+
+        The 'locations' property is an array that may be specified as a tuple,
+        list, numpy array, or pandas Series
+
+        Returns
+        -------
+        numpy.ndarray
+        """
+        return self["locations"]
+
+    @locations.setter
+    def locations(self, val):
+        self["locations"] = val
+
+    # locationssrc
+    # ------------
+    @property
+    def locationssrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `locations`.
+
+        The 'locationssrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["locationssrc"]
+
+    @locationssrc.setter
+    def locationssrc(self, val):
+        self["locationssrc"] = val
+
+    # show
+    # ----
+    @property
+    def show(self):
+        """
+        Determines whether or not slice planes about the x dimension
+        are drawn.
+
+        The 'show' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["show"]
+
+    @show.setter
+    def show(self, val):
+        self["show"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        fill
+            Sets the fill ratio of the `slices`. The default fill
+            value of the `slices` is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+        locations
+            Specifies the location(s) of slices on the axis. When
+            not specified slices would be created for all points of
+            the axis x except start and end.
+        locationssrc
+            Sets the source reference on Chart Studio Cloud for
+            `locations`.
+        show
+            Determines whether or not slice planes about the x
+            dimension are drawn.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        fill=None,
+        locations=None,
+        locationssrc=None,
+        show=None,
+        **kwargs,
+    ):
+        """
+        Construct a new X object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.volume.slices.X`
+        fill
+            Sets the fill ratio of the `slices`. The default fill
+            value of the `slices` is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+        locations
+            Specifies the location(s) of slices on the axis. When
+            not specified slices would be created for all points of
+            the axis x except start and end.
+        locationssrc
+            Sets the source reference on Chart Studio Cloud for
+            `locations`.
+        show
+            Determines whether or not slice planes about the x
+            dimension are drawn.
+
+        Returns
+        -------
+        X
+        """
+        super(X, self).__init__("x")
+
+        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.volume.slices.X
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.slices.X`"""
+            )
+
+        # 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("fill", None)
+        _v = fill if fill is not None else _v
+        if _v is not None:
+            self["fill"] = _v
+        _v = arg.pop("locations", None)
+        _v = locations if locations is not None else _v
+        if _v is not None:
+            self["locations"] = _v
+        _v = arg.pop("locationssrc", None)
+        _v = locationssrc if locationssrc is not None else _v
+        if _v is not None:
+            self["locationssrc"] = _v
+        _v = arg.pop("show", None)
+        _v = show if show is not None else _v
+        if _v is not None:
+            self["show"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/volume/slices/_y.py

@@ -0,0 +1,214 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Y(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume.slices"
+    _path_str = "volume.slices.y"
+    _valid_props = {"fill", "locations", "locationssrc", "show"}
+
+    # fill
+    # ----
+    @property
+    def fill(self):
+        """
+        Sets the fill ratio of the `slices`. The default fill value of
+        the `slices` is 1 meaning that they are entirely shaded. On the
+        other hand Applying a `fill` ratio less than one would allow
+        the creation of openings parallel to the edges.
+
+        The 'fill' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["fill"]
+
+    @fill.setter
+    def fill(self, val):
+        self["fill"] = val
+
+    # locations
+    # ---------
+    @property
+    def locations(self):
+        """
+        Specifies the location(s) of slices on the axis. When not
+        specified slices would be created for all points of the axis y
+        except start and end.
+
+        The 'locations' property is an array that may be specified as a tuple,
+        list, numpy array, or pandas Series
+
+        Returns
+        -------
+        numpy.ndarray
+        """
+        return self["locations"]
+
+    @locations.setter
+    def locations(self, val):
+        self["locations"] = val
+
+    # locationssrc
+    # ------------
+    @property
+    def locationssrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `locations`.
+
+        The 'locationssrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["locationssrc"]
+
+    @locationssrc.setter
+    def locationssrc(self, val):
+        self["locationssrc"] = val
+
+    # show
+    # ----
+    @property
+    def show(self):
+        """
+        Determines whether or not slice planes about the y dimension
+        are drawn.
+
+        The 'show' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["show"]
+
+    @show.setter
+    def show(self, val):
+        self["show"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        fill
+            Sets the fill ratio of the `slices`. The default fill
+            value of the `slices` is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+        locations
+            Specifies the location(s) of slices on the axis. When
+            not specified slices would be created for all points of
+            the axis y except start and end.
+        locationssrc
+            Sets the source reference on Chart Studio Cloud for
+            `locations`.
+        show
+            Determines whether or not slice planes about the y
+            dimension are drawn.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        fill=None,
+        locations=None,
+        locationssrc=None,
+        show=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Y object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.volume.slices.Y`
+        fill
+            Sets the fill ratio of the `slices`. The default fill
+            value of the `slices` is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+        locations
+            Specifies the location(s) of slices on the axis. When
+            not specified slices would be created for all points of
+            the axis y except start and end.
+        locationssrc
+            Sets the source reference on Chart Studio Cloud for
+            `locations`.
+        show
+            Determines whether or not slice planes about the y
+            dimension are drawn.
+
+        Returns
+        -------
+        Y
+        """
+        super(Y, self).__init__("y")
+
+        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.volume.slices.Y
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.slices.Y`"""
+            )
+
+        # 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("fill", None)
+        _v = fill if fill is not None else _v
+        if _v is not None:
+            self["fill"] = _v
+        _v = arg.pop("locations", None)
+        _v = locations if locations is not None else _v
+        if _v is not None:
+            self["locations"] = _v
+        _v = arg.pop("locationssrc", None)
+        _v = locationssrc if locationssrc is not None else _v
+        if _v is not None:
+            self["locationssrc"] = _v
+        _v = arg.pop("show", None)
+        _v = show if show is not None else _v
+        if _v is not None:
+            self["show"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/volume/slices/_z.py

@@ -0,0 +1,214 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Z(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "volume.slices"
+    _path_str = "volume.slices.z"
+    _valid_props = {"fill", "locations", "locationssrc", "show"}
+
+    # fill
+    # ----
+    @property
+    def fill(self):
+        """
+        Sets the fill ratio of the `slices`. The default fill value of
+        the `slices` is 1 meaning that they are entirely shaded. On the
+        other hand Applying a `fill` ratio less than one would allow
+        the creation of openings parallel to the edges.
+
+        The 'fill' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["fill"]
+
+    @fill.setter
+    def fill(self, val):
+        self["fill"] = val
+
+    # locations
+    # ---------
+    @property
+    def locations(self):
+        """
+        Specifies the location(s) of slices on the axis. When not
+        specified slices would be created for all points of the axis z
+        except start and end.
+
+        The 'locations' property is an array that may be specified as a tuple,
+        list, numpy array, or pandas Series
+
+        Returns
+        -------
+        numpy.ndarray
+        """
+        return self["locations"]
+
+    @locations.setter
+    def locations(self, val):
+        self["locations"] = val
+
+    # locationssrc
+    # ------------
+    @property
+    def locationssrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `locations`.
+
+        The 'locationssrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["locationssrc"]
+
+    @locationssrc.setter
+    def locationssrc(self, val):
+        self["locationssrc"] = val
+
+    # show
+    # ----
+    @property
+    def show(self):
+        """
+        Determines whether or not slice planes about the z dimension
+        are drawn.
+
+        The 'show' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["show"]
+
+    @show.setter
+    def show(self, val):
+        self["show"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        fill
+            Sets the fill ratio of the `slices`. The default fill
+            value of the `slices` is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+        locations
+            Specifies the location(s) of slices on the axis. When
+            not specified slices would be created for all points of
+            the axis z except start and end.
+        locationssrc
+            Sets the source reference on Chart Studio Cloud for
+            `locations`.
+        show
+            Determines whether or not slice planes about the z
+            dimension are drawn.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        fill=None,
+        locations=None,
+        locationssrc=None,
+        show=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Z object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.volume.slices.Z`
+        fill
+            Sets the fill ratio of the `slices`. The default fill
+            value of the `slices` is 1 meaning that they are
+            entirely shaded. On the other hand Applying a `fill`
+            ratio less than one would allow the creation of
+            openings parallel to the edges.
+        locations
+            Specifies the location(s) of slices on the axis. When
+            not specified slices would be created for all points of
+            the axis z except start and end.
+        locationssrc
+            Sets the source reference on Chart Studio Cloud for
+            `locations`.
+        show
+            Determines whether or not slice planes about the z
+            dimension are drawn.
+
+        Returns
+        -------
+        Z
+        """
+        super(Z, self).__init__("z")
+
+        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.volume.slices.Z
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.volume.slices.Z`"""
+            )
+
+        # 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("fill", None)
+        _v = fill if fill is not None else _v
+        if _v is not None:
+            self["fill"] = _v
+        _v = arg.pop("locations", None)
+        _v = locations if locations is not None else _v
+        if _v is not None:
+            self["locations"] = _v
+        _v = arg.pop("locationssrc", None)
+        _v = locationssrc if locationssrc is not None else _v
+        if _v is not None:
+            self["locationssrc"] = _v
+        _v = arg.pop("show", None)
+        _v = show if show is not None else _v
+        if _v is not None:
+            self["show"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False