streamlit-data-editor-plus 0.1.0__py3-none-any.whl

streamlit/elements/graphviz_chart.py

@@ -0,0 +1,226 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2026)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Streamlit support for GraphViz charts."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, TypeAlias, Union, cast
+
+from streamlit import type_util
+from streamlit.deprecation_util import (
+    make_deprecated_name_warning,
+    show_deprecation_warning,
+)
+from streamlit.elements.lib.layout_utils import (
+    Height,
+    LayoutConfig,
+    Width,
+    validate_height,
+    validate_width,
+)
+from streamlit.errors import StreamlitAPIException
+from streamlit.proto.GraphVizChart_pb2 import GraphVizChart as GraphVizChartProto
+from streamlit.runtime.metrics_util import gather_metrics
+from streamlit.util import calc_md5
+
+if TYPE_CHECKING:
+    import graphviz
+
+    from streamlit.delta_generator import DeltaGenerator
+
+FigureOrDot: TypeAlias = Union[
+    "graphviz.Graph", "graphviz.Digraph", "graphviz.Source", str
+]
+
+
+class GraphvizMixin:
+    @gather_metrics("graphviz_chart")
+    def graphviz_chart(
+        self,
+        figure_or_dot: FigureOrDot,
+        use_container_width: bool | None = None,
+        *,  # keyword-only arguments:
+        width: Width = "content",
+        height: Height = "content",
+    ) -> DeltaGenerator:
+        """Display a graph using the dagre-d3 library.
+
+        .. Important::
+            You must install ``graphviz>=0.19.0`` to use this command. You can
+            install all charting dependencies (except Bokeh) as an extra with
+            Streamlit:
+
+            .. code-block:: shell
+
+               pip install streamlit[charts]
+
+        Parameters
+        ----------
+        figure_or_dot : graphviz.dot.Graph, graphviz.dot.Digraph, graphviz.sources.Source, str
+            The Graphlib graph object or dot string to display
+
+        use_container_width : bool
+            Whether to override the figure's native width with the width of
+            the parent container. If ``use_container_width`` is ``False``
+            (default), Streamlit sets the width of the chart to fit its contents
+            according to the plotting library, up to the width of the parent
+            container. If ``use_container_width`` is ``True``, Streamlit sets
+            the width of the figure to match the width of the parent container.
+
+            .. deprecated::
+                ``use_container_width`` is deprecated and will be removed in a
+                future release. For ``use_container_width=True``, use
+                ``width="stretch"``. For ``use_container_width=False``, use
+                ``width="content"``.
+
+        width : "content", "stretch", or int
+            The width of the chart element. This can be one of the following:
+
+            - ``"content"`` (default): The width of the element matches the
+              width of its content, but doesn't exceed the width of the parent
+              container.
+            - ``"stretch"``: The width of the element matches the width of the
+              parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
+
+        height : "content", "stretch", or int
+            The height of the chart element. This can be one of the following:
+
+            - ``"content"`` (default): The height of the element matches the
+              height of its content.
+            - ``"stretch"``: The height of the element matches the height of
+              its content or the height of the parent container, whichever is
+              larger. If the element is not in a parent container, the height
+              of the element matches the height of its content.
+            - An integer specifying the height in pixels: The element has a
+              fixed height. If the content is larger than the specified
+              height, scrolling is enabled.
+
+        Example
+        -------
+        >>> import streamlit as st
+        >>> import graphviz
+        >>>
+        >>> # Create a graphlib graph object
+        >>> graph = graphviz.Digraph()
+        >>> graph.edge("run", "intr")
+        >>> graph.edge("intr", "runbl")
+        >>> graph.edge("runbl", "run")
+        >>> graph.edge("run", "kernel")
+        >>> graph.edge("kernel", "zombie")
+        >>> graph.edge("kernel", "sleep")
+        >>> graph.edge("kernel", "runmem")
+        >>> graph.edge("sleep", "swap")
+        >>> graph.edge("swap", "runswap")
+        >>> graph.edge("runswap", "new")
+        >>> graph.edge("runswap", "runmem")
+        >>> graph.edge("new", "runmem")
+        >>> graph.edge("sleep", "runmem")
+        >>>
+        >>> st.graphviz_chart(graph)
+
+        Or you can render the chart from the graph using GraphViz's Dot
+        language:
+
+        >>> st.graphviz_chart('''
+            digraph {
+                run -> intr
+                intr -> runbl
+                runbl -> run
+                run -> kernel
+                kernel -> zombie
+                kernel -> sleep
+                kernel -> runmem
+                sleep -> swap
+                swap -> runswap
+                runswap -> new
+                runswap -> runmem
+                new -> runmem
+                sleep -> runmem
+            }
+        ''')
+
+        .. output::
+           https://doc-graphviz-chart.streamlit.app/
+           height: 600px
+
+        """
+        if use_container_width is not None:
+            show_deprecation_warning(
+                make_deprecated_name_warning(
+                    "use_container_width",
+                    "width",
+                    "2025-12-31",
+                    "For `use_container_width=True`, use `width='stretch'`. "
+                    "For `use_container_width=False`, use `width='content'`.",
+                    include_st_prefix=False,
+                ),
+                show_in_browser=False,
+            )
+            width = "stretch" if use_container_width else "content"
+
+        # Generate element ID from delta path
+        delta_path = self.dg._get_delta_path_str()
+        element_id = calc_md5(delta_path.encode())
+
+        graphviz_chart_proto = GraphVizChartProto()
+
+        marshall(graphviz_chart_proto, figure_or_dot, element_id)
+
+        # Validate and set layout configuration
+        validate_width(width, allow_content=True)
+        validate_height(height, allow_content=True)
+        layout_config = LayoutConfig(width=width, height=height)
+
+        return self.dg._enqueue(
+            "graphviz_chart", graphviz_chart_proto, layout_config=layout_config
+        )
+
+    @property
+    def dg(self) -> DeltaGenerator:
+        """Get our DeltaGenerator."""
+        return cast("DeltaGenerator", self)
+
+
+def marshall(
+    proto: GraphVizChartProto,
+    figure_or_dot: FigureOrDot,
+    element_id: str,
+) -> None:
+    """Construct a GraphViz chart object.
+
+    See DeltaGenerator.graphviz_chart for docs.
+    """
+
+    if type_util.is_graphviz_chart(figure_or_dot):
+        chart = cast(
+            "graphviz.Graph | graphviz.Digraph | graphviz.Source", figure_or_dot
+        )
+        dot = chart.source
+        engine = chart.engine
+    elif isinstance(figure_or_dot, str):
+        dot = figure_or_dot
+        engine = "dot"
+    else:
+        raise StreamlitAPIException(
+            f"Unhandled type for graphviz chart: {type(figure_or_dot)}"
+        )
+
+    proto.spec = dot
+    proto.engine = engine
+    proto.element_id = element_id

streamlit/elements/heading.py

@@ -0,0 +1,407 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2026)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import TYPE_CHECKING, Literal, TypeAlias, cast
+
+from streamlit.elements.lib.layout_utils import LayoutConfig, validate_width
+from streamlit.errors import StreamlitAPIException
+from streamlit.proto.Heading_pb2 import Heading as HeadingProto
+from streamlit.runtime.metrics_util import gather_metrics
+from streamlit.string_util import clean_text
+
+if TYPE_CHECKING:
+    from streamlit.delta_generator import DeltaGenerator
+    from streamlit.elements.lib.layout_utils import TextAlignment, Width
+    from streamlit.type_util import SupportsStr
+
+
+class HeadingProtoTag(Enum):
+    TITLE_TAG = "h1"
+    HEADER_TAG = "h2"
+    SUBHEADER_TAG = "h3"
+
+
+Anchor: TypeAlias = str | Literal[False] | None
+Divider: TypeAlias = bool | str | None
+
+
+class HeadingMixin:
+    @gather_metrics("header")
+    def header(
+        self,
+        body: SupportsStr,
+        anchor: Anchor = None,
+        *,  # keyword-only arguments:
+        help: str | None = None,
+        divider: Divider = False,
+        width: Width = "stretch",
+        text_alignment: TextAlignment = "left",
+    ) -> DeltaGenerator:
+        """Display text in header formatting.
+
+        Parameters
+        ----------
+        body : str
+            The text to display as GitHub-flavored Markdown. Syntax
+            information can be found at: https://github.github.com/gfm.
+
+            See the ``body`` parameter of |st.markdown|_ for additional,
+            supported Markdown directives.
+
+            .. |st.markdown| replace:: ``st.markdown``
+            .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
+
+        anchor : str or False
+            The anchor name of the header that can be accessed with #anchor
+            in the URL. If omitted, it generates an anchor using the body.
+            If False, the anchor is not shown in the UI.
+
+        help : str or None
+            A tooltip that gets displayed next to the header. If this is
+            ``None`` (default), no tooltip is displayed.
+
+            The tooltip can optionally contain GitHub-flavored Markdown,
+            including the Markdown directives described in the ``body``
+            parameter of ``st.markdown``.
+
+        divider : bool, "blue", "green", "orange", "red", "violet", "yellow", "gray"/"grey", or "rainbow"
+            Shows a colored divider below the header. If this is ``True``,
+            successive headers will cycle through divider colors, except gray
+            and rainbow. That is, the first header will have a blue line, the
+            second header will have a green line, and so on. If this is a
+            string, the color can be set to one of the following: blue, green,
+            orange, red, violet, yellow, gray/grey, or rainbow.
+
+        width : "stretch", "content", or int
+            The width of the header element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - ``"content"``: The width of the element matches the width of its
+              content, but doesn't exceed the width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
+
+        text_alignment : "left", "center", "right", or "justify"
+            The horizontal alignment of the text within the element. This can
+            be one of the following:
+
+            - ``"left"`` (default): Text is aligned to the left edge.
+            - ``"center"``: Text is centered.
+            - ``"right"``: Text is aligned to the right edge.
+            - ``"justify"``: Text is justified (stretched to fill the available
+              width with the last line left-aligned).
+
+            .. note::
+                For text alignment to have a visible effect, the element's
+                width must be wider than its content. If you use
+                ``width="content"`` with short text, the alignment may not be
+                noticeable.
+
+        Examples
+        --------
+        >>> import streamlit as st
+        >>>
+        >>> st.header("_Streamlit_ is :blue[cool] :sunglasses:")
+        >>> st.header("This is a header with a divider", divider="gray")
+        >>> st.header("These headers have rotating dividers", divider=True)
+        >>> st.header("One", divider=True)
+        >>> st.header("Two", divider=True)
+        >>> st.header("Three", divider=True)
+        >>> st.header("Four", divider=True)
+
+        .. output::
+           https://doc-header.streamlit.app/
+           height: 600px
+
+        """
+        validate_width(width, allow_content=True)
+        layout_config = LayoutConfig(width=width, text_alignment=text_alignment)
+
+        return self.dg._enqueue(
+            "heading",
+            HeadingMixin._create_heading_proto(
+                tag=HeadingProtoTag.HEADER_TAG,
+                body=body,
+                anchor=anchor,
+                help=help,
+                divider=divider,
+            ),
+            layout_config=layout_config,
+        )
+
+    @gather_metrics("subheader")
+    def subheader(
+        self,
+        body: SupportsStr,
+        anchor: Anchor = None,
+        *,  # keyword-only arguments:
+        help: str | None = None,
+        divider: Divider = False,
+        width: Width = "stretch",
+        text_alignment: TextAlignment = "left",
+    ) -> DeltaGenerator:
+        """Display text in subheader formatting.
+
+        Parameters
+        ----------
+        body : str
+            The text to display as GitHub-flavored Markdown. Syntax
+            information can be found at: https://github.github.com/gfm.
+
+            See the ``body`` parameter of |st.markdown|_ for additional,
+            supported Markdown directives.
+
+            .. |st.markdown| replace:: ``st.markdown``
+            .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
+
+        anchor : str or False
+            The anchor name of the header that can be accessed with #anchor
+            in the URL. If omitted, it generates an anchor using the body.
+            If False, the anchor is not shown in the UI.
+
+        help : str or None
+            A tooltip that gets displayed next to the subheader. If this is
+            ``None`` (default), no tooltip is displayed.
+
+            The tooltip can optionally contain GitHub-flavored Markdown,
+            including the Markdown directives described in the ``body``
+            parameter of ``st.markdown``.
+
+        divider : bool, "blue", "green", "orange", "red", "violet", "yellow", "gray"/"grey", or "rainbow"
+            Shows a colored divider below the header. If this is ``True``,
+            successive headers will cycle through divider colors, except gray
+            and rainbow. That is, the first header will have a blue line, the
+            second header will have a green line, and so on. If this is a
+            string, the color can be set to one of the following: blue, green,
+            orange, red, violet, yellow, gray/grey, or rainbow.
+
+        width : "stretch", "content", or int
+            The width of the subheader element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - ``"content"``: The width of the element matches the width of its
+              content, but doesn't exceed the width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
+
+        text_alignment : "left", "center", "right", or "justify"
+            The horizontal alignment of the text within the element. This can
+            be one of the following:
+
+            - ``"left"`` (default): Text is aligned to the left edge.
+            - ``"center"``: Text is centered.
+            - ``"right"``: Text is aligned to the right edge.
+            - ``"justify"``: Text is justified (stretched to fill the available
+              width with the last line left-aligned).
+
+            .. note::
+                For text alignment to have a visible effect, the element's
+                width must be wider than its content. If you use
+                ``width="content"`` with short text, the alignment may not be
+                noticeable.
+
+        Examples
+        --------
+        >>> import streamlit as st
+        >>>
+        >>> st.subheader("_Streamlit_ is :blue[cool] :sunglasses:")
+        >>> st.subheader("This is a subheader with a divider", divider="gray")
+        >>> st.subheader("These subheaders have rotating dividers", divider=True)
+        >>> st.subheader("One", divider=True)
+        >>> st.subheader("Two", divider=True)
+        >>> st.subheader("Three", divider=True)
+        >>> st.subheader("Four", divider=True)
+
+        .. output::
+           https://doc-subheader.streamlit.app/
+           height: 500px
+
+        """
+        validate_width(width, allow_content=True)
+        layout_config = LayoutConfig(width=width, text_alignment=text_alignment)
+
+        return self.dg._enqueue(
+            "heading",
+            HeadingMixin._create_heading_proto(
+                tag=HeadingProtoTag.SUBHEADER_TAG,
+                body=body,
+                anchor=anchor,
+                help=help,
+                divider=divider,
+            ),
+            layout_config=layout_config,
+        )
+
+    @gather_metrics("title")
+    def title(
+        self,
+        body: SupportsStr,
+        anchor: Anchor = None,
+        *,  # keyword-only arguments:
+        help: str | None = None,
+        width: Width = "stretch",
+        text_alignment: TextAlignment = "left",
+    ) -> DeltaGenerator:
+        """Display text in title formatting.
+
+        Each document should have a single `st.title()`, although this is not
+        enforced.
+
+        Parameters
+        ----------
+        body : str
+            The text to display as GitHub-flavored Markdown. Syntax
+            information can be found at: https://github.github.com/gfm.
+
+            See the ``body`` parameter of |st.markdown|_ for additional,
+            supported Markdown directives.
+
+            .. |st.markdown| replace:: ``st.markdown``
+            .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
+
+        anchor : str or False
+            The anchor name of the header that can be accessed with #anchor
+            in the URL. If omitted, it generates an anchor using the body.
+            If False, the anchor is not shown in the UI.
+
+        help : str or None
+            A tooltip that gets displayed next to the title. If this is
+            ``None`` (default), no tooltip is displayed.
+
+            The tooltip can optionally contain GitHub-flavored Markdown,
+            including the Markdown directives described in the ``body``
+            parameter of ``st.markdown``.
+
+        width : "stretch", "content", or int
+            The width of the title element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - ``"content"``: The width of the element matches the width of its
+              content, but doesn't exceed the width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
+
+        text_alignment : "left", "center", "right", or "justify"
+            The horizontal alignment of the text within the element. This can
+            be one of the following:
+
+            - ``"left"`` (default): Text is aligned to the left edge.
+            - ``"center"``: Text is centered.
+            - ``"right"``: Text is aligned to the right edge.
+            - ``"justify"``: Text is justified (stretched to fill the available
+              width with the last line left-aligned).
+
+            .. note::
+                For text alignment to have a visible effect, the element's
+                width must be wider than its content. If you use
+                ``width="content"`` with short text, the alignment may not be
+                noticeable.
+
+        Examples
+        --------
+        >>> import streamlit as st
+        >>>
+        >>> st.title("This is a title")
+        >>> st.title("_Streamlit_ is :blue[cool] :sunglasses:")
+
+        .. output::
+           https://doc-title.streamlit.app/
+           height: 220px
+
+        """
+        validate_width(width, allow_content=True)
+        layout_config = LayoutConfig(width=width, text_alignment=text_alignment)
+
+        return self.dg._enqueue(
+            "heading",
+            HeadingMixin._create_heading_proto(
+                tag=HeadingProtoTag.TITLE_TAG,
+                body=body,
+                anchor=anchor,
+                help=help,
+            ),
+            layout_config=layout_config,
+        )
+
+    @property
+    def dg(self) -> DeltaGenerator:
+        """Get our DeltaGenerator."""
+        return cast("DeltaGenerator", self)
+
+    @staticmethod
+    def _handle_divider_color(divider: Divider) -> str:
+        if divider is True:
+            return "auto"
+        valid_colors = [
+            "red",
+            "orange",
+            "yellow",
+            "blue",
+            "green",
+            "violet",
+            "gray",
+            "grey",
+            "rainbow",
+        ]
+        if divider in valid_colors:
+            return cast("str", divider)
+        raise StreamlitAPIException(
+            f"Divider parameter has invalid value: `{divider}`. Please choose from: {', '.join(valid_colors)}."
+        )
+
+    @staticmethod
+    def _create_heading_proto(
+        tag: HeadingProtoTag,
+        body: SupportsStr,
+        anchor: Anchor = None,
+        help: str | None = None,
+        divider: Divider = False,
+    ) -> HeadingProto:
+        proto = HeadingProto()
+        proto.tag = tag.value
+        proto.body = clean_text(body)
+        if divider:
+            proto.divider = HeadingMixin._handle_divider_color(divider)
+        if anchor is not None:
+            if anchor is False:
+                proto.hide_anchor = True
+            elif isinstance(anchor, str):
+                proto.anchor = anchor
+            elif anchor is True:  # type: ignore
+                raise StreamlitAPIException(
+                    f"Anchor parameter has invalid value: {anchor}. "
+                    "Supported values: None, any string or False"
+                )
+            else:
+                raise StreamlitAPIException(
+                    f"Anchor parameter has invalid type: {type(anchor).__name__}. "
+                    "Supported values: None, any string or False"
+                )
+
+        if help:
+            proto.help = help
+
+        return proto