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

streamlit/elements/balloons.py

@@ -0,0 +1,47 @@
+# 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 typing import TYPE_CHECKING, cast
+
+from streamlit.proto.Balloons_pb2 import Balloons as BalloonsProto
+from streamlit.runtime.metrics_util import gather_metrics
+
+if TYPE_CHECKING:
+    from streamlit.delta_generator import DeltaGenerator
+
+
+class BalloonsMixin:
+    @gather_metrics("balloons")
+    def balloons(self) -> DeltaGenerator:
+        """Draw celebratory balloons.
+
+        Example
+        -------
+        >>> import streamlit as st
+        >>>
+        >>> st.balloons()
+
+        ...then watch your app and get ready for a celebration!
+
+        """
+        balloons_proto = BalloonsProto()
+        balloons_proto.show = True
+        return self.dg._enqueue("balloons", balloons_proto)
+
+    @property
+    def dg(self) -> DeltaGenerator:
+        """Get our DeltaGenerator."""
+        return cast("DeltaGenerator", self)

streamlit/elements/bokeh_chart.py

@@ -0,0 +1,75 @@
+# 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.
+
+"""A Python wrapper around Bokeh."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, cast
+
+from streamlit.deprecation_util import (
+    show_deprecation_warning,
+)
+from streamlit.runtime.metrics_util import gather_metrics
+
+if TYPE_CHECKING:
+    from streamlit.delta_generator import DeltaGenerator
+
+
+class BokehMixin:
+    @gather_metrics("bokeh_chart")
+    def bokeh_chart(
+        self,
+        figure: object,  # noqa: ARG002
+        use_container_width: bool = True,  # noqa: ARG002
+    ) -> DeltaGenerator:
+        """Display an interactive Bokeh chart.
+
+        Bokeh is a charting library for Python. You can find
+        more about Bokeh at https://bokeh.pydata.org.
+
+        .. Important::
+            This command has been deprecated and removed. Please use our custom
+            component, |streamlit-bokeh|_, instead. Calling st.bokeh_chart will
+            do nothing.
+
+        .. |streamlit-bokeh| replace:: ``streamlit-bokeh``
+        .. _streamlit-bokeh: https://github.com/streamlit/streamlit-bokeh
+
+        Parameters
+        ----------
+        figure : bokeh.plotting.figure.Figure
+            A Bokeh figure to plot.
+
+        use_container_width : bool
+            Whether to override the figure's native width with the width of
+            the parent container. If ``use_container_width`` is ``True`` (default),
+            Streamlit sets the width of the figure to match the width of the parent
+            container. If ``use_container_width`` is ``False``, Streamlit sets the
+            width of the chart to fit its contents according to the plotting library,
+            up to the width of the parent container.
+        """
+
+        show_deprecation_warning(
+            "st.bokeh_chart has been deprecated and removed. "
+            "Please use our custom component, "
+            "[streamlit-bokeh](https://github.com/streamlit/streamlit-bokeh), "
+            "instead. Calling st.bokeh_chart will do nothing."
+        )
+        return self.dg
+
+    @property
+    def dg(self) -> DeltaGenerator:
+        """Get our DeltaGenerator."""
+        return cast("DeltaGenerator", self)

streamlit/elements/code.py

@@ -0,0 +1,154 @@
+# 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
+
+import re
+from typing import TYPE_CHECKING, cast
+
+from streamlit.elements.lib.layout_utils import (
+    Height,
+    LayoutConfig,
+    Width,
+    validate_height,
+    validate_width,
+)
+from streamlit.proto.Code_pb2 import Code as CodeProto
+from streamlit.runtime.metrics_util import gather_metrics
+
+if TYPE_CHECKING:
+    from streamlit.delta_generator import DeltaGenerator
+    from streamlit.type_util import SupportsStr
+
+
+class CodeMixin:
+    @gather_metrics("code")
+    def code(
+        self,
+        body: SupportsStr,
+        language: str | None = "python",
+        *,
+        line_numbers: bool = False,
+        wrap_lines: bool = False,
+        height: Height | None = "content",
+        width: Width = "stretch",
+    ) -> DeltaGenerator:
+        """Display a code block with optional syntax highlighting.
+
+        Parameters
+        ----------
+        body : str
+            The string to display as code or monospace text.
+
+        language : str or None
+            The language that the code is written in, for syntax highlighting.
+            This defaults to ``"python"``. If this is ``None``, the code will
+            be plain, monospace text.
+
+            For a list of available ``language`` values, see
+            `react-syntax-highlighter
+            <https://github.com/react-syntax-highlighter/react-syntax-highlighter/blob/master/AVAILABLE_LANGUAGES_PRISM.MD>`_
+            on GitHub.
+
+        line_numbers : bool
+            An optional boolean indicating whether to show line numbers to the
+            left of the code block. This defaults to ``False``.
+
+        wrap_lines : bool
+            An optional boolean indicating whether to wrap lines. This defaults
+            to ``False``.
+
+        height : "content", "stretch", or int
+            The height of the code block 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.
+
+            .. note::
+                Use scrolling containers sparingly. If you use scrolling
+                containers, avoid heights that exceed 500 pixels. Otherwise,
+                the scroll surface of the container might cover the majority of
+                the screen on mobile devices, which makes it hard to scroll the
+                rest of the app.
+
+        width : "stretch", "content", or int
+            The width of the code block 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.
+
+        Examples
+        --------
+        >>> import streamlit as st
+        >>>
+        >>> code = '''def hello():
+        ...     print("Hello, Streamlit!")'''
+        >>> st.code(code, language="python")
+
+        .. output::
+            https://doc-code.streamlit.app/
+            height: 220px
+
+        >>> import streamlit as st
+        >>> code = '''Is it a crown or boat?
+        ...                         ii
+        ...                       iiiiii
+        ... WWw                 .iiiiiiii.                ...:
+        ...  WWWWWWw          .iiiiiiiiiiii.         ........
+        ...   WWWWWWWWWWw    iiiiiiiiiiiiiiii    ...........
+        ...    WWWWWWWWWWWWWWwiiiiiiiiiiiiiiiii............
+        ...     WWWWWWWWWWWWWWWWWWwiiiiiiiiiiiiii.........
+        ...      WWWWWWWWWWWWWWWWWWWWWWwiiiiiiiiii.......
+        ...       WWWWWWWWWWWWWWWWWWWWWWWWWWwiiiiiii....
+        ...        WWWWWWWWWWWWWWWWWWWWWWWWWWWWWWwiiii.
+        ...           -MMMWWWWWWWWWWWWWWWWWWWWWWMMM-
+        ... '''
+        >>> st.code(code, language=None)
+
+        .. output::
+            https://doc-code-ascii.streamlit.app/
+            height: 380px
+        """
+        code_proto = CodeProto()
+        code_proto.code_text = re.sub(r"\n\Z", "", re.sub(r"\A\n", "", str(body)))
+        code_proto.language = language or "plaintext"
+        code_proto.show_line_numbers = line_numbers
+        code_proto.wrap_lines = wrap_lines
+
+        if height is None:
+            height = "content"
+        else:
+            validate_height(height, allow_content=True)
+        validate_width(width, allow_content=True)
+        layout_config = LayoutConfig(height=height, width=width)
+
+        return self.dg._enqueue("code", code_proto, layout_config=layout_config)
+
+    @property
+    def dg(self) -> DeltaGenerator:
+        """Get our DeltaGenerator."""
+        return cast("DeltaGenerator", self)