streamlit-nightly 1.43.2.dev20250307__py3-none-any.whl

streamlit/static/static/media/snowflake.JU2jBHL8.svg

@@ -0,0 +1,11 @@
+<svg width="25" height="24" viewBox="0 0 25 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g id="Logo-solid">
+<path id="inside" fill-rule="evenodd" clip-rule="evenodd" d="M13.5357 12.1774L12.801 12.912C12.7029 13.0101 12.5439 13.0101 12.4458 12.912L11.7112 12.1774C11.6131 12.0794 11.6131 11.9203 11.7112 11.8223L12.4458 11.0876C12.5439 10.9894 12.703 10.9894 12.8011 11.0876L13.5357 11.8222C13.6337 11.9203 13.6337 12.0793 13.5357 12.1774ZM15.0724 11.2524L13.3708 9.55073C12.9581 9.13804 12.2889 9.13804 11.8761 9.55073L10.1744 11.2525C9.76154 11.6653 9.76154 12.3345 10.1744 12.7473L11.876 14.4489C12.2887 14.8616 12.9579 14.8616 13.3707 14.4489L15.0724 12.7471C15.4852 12.3343 15.4852 11.6651 15.0724 11.2524Z" fill="#29B5E8"/>
+<path id="petal 6" fill-rule="evenodd" clip-rule="evenodd" d="M9.79594 0C8.95801 0 8.2787 0.679312 8.2787 1.51724V4.65891L5.53731 3.07614C4.81165 2.65718 3.88372 2.9058 3.46476 3.63153C3.04579 4.35718 3.29441 5.28512 4.02007 5.70408L8.83304 8.48285C9.09497 8.69823 9.43036 8.82761 9.79594 8.82761C10.6339 8.82761 11.3132 8.14829 11.3132 7.31036V1.51724C11.3132 0.679312 10.6339 0 9.79594 0Z" fill="#29B5E8"/>
+<path id="petal 5" fill-rule="evenodd" clip-rule="evenodd" d="M8.60315 12.5758C8.61253 12.553 8.62177 12.5303 8.62997 12.5071C8.63915 12.4812 8.64722 12.4552 8.65494 12.429C8.66087 12.4088 8.66673 12.3888 8.67184 12.3685C8.67887 12.3405 8.6848 12.3124 8.69018 12.2841C8.69397 12.2642 8.69756 12.2443 8.7006 12.2243C8.70473 12.1967 8.70791 12.1692 8.71046 12.1414C8.71253 12.1194 8.71425 12.0975 8.71542 12.0754C8.71666 12.0503 8.71708 12.0252 8.71708 12C8.71708 11.9748 8.71666 11.9498 8.71542 11.9246C8.71425 11.9025 8.71253 11.8805 8.71046 11.8586C8.70791 11.8309 8.70473 11.8034 8.7006 11.7756C8.69756 11.7556 8.69397 11.7358 8.69018 11.7158C8.6848 11.6876 8.67887 11.6596 8.67184 11.6315C8.66673 11.6112 8.66087 11.5912 8.65494 11.5711C8.64722 11.5449 8.63915 11.5188 8.62997 11.4929C8.62177 11.4697 8.61253 11.4469 8.60315 11.4242C8.59418 11.4023 8.58528 11.3805 8.57522 11.3589C8.56246 11.3316 8.54825 11.3049 8.53391 11.2784C8.52722 11.2661 8.52198 11.2535 8.51501 11.2414C8.51232 11.2367 8.50901 11.2325 8.50625 11.2279C8.48956 11.1996 8.47122 11.1722 8.45259 11.1449C8.44266 11.1303 8.43308 11.1152 8.42266 11.1009C8.40466 11.0765 8.38515 11.0532 8.3657 11.0298C8.35253 11.014 8.3399 10.9978 8.32625 10.9826C8.30922 10.9638 8.29087 10.9462 8.27287 10.9281C8.2548 10.9101 8.23715 10.8917 8.21839 10.8747C8.20322 10.8612 8.18701 10.8485 8.17122 10.8354C8.14777 10.8158 8.12453 10.7963 8.10004 10.7784C8.08584 10.7679 8.07073 10.7583 8.05604 10.7484C8.0288 10.7298 8.00142 10.7115 7.97308 10.6947C7.96846 10.6921 7.96432 10.6887 7.95963 10.6861L2.94265 7.78949C2.21693 7.37046 1.28899 7.61915 0.870026 8.3448C0.45106 9.07053 0.699681 9.99846 1.42541 10.4174L4.16652 12L1.42541 13.5826C0.699681 14.0016 0.45106 14.9295 0.870026 15.6552C1.28899 16.3809 2.21693 16.6295 2.94265 16.2105L7.95963 13.314C7.96432 13.3112 7.96846 13.308 7.97308 13.3052C8.00142 13.2885 8.0288 13.2702 8.05604 13.2516C8.07073 13.2416 8.08584 13.2321 8.10004 13.2216C8.12453 13.2036 8.14777 13.1841 8.17122 13.1646C8.18701 13.1516 8.20322 13.1389 8.21839 13.1252C8.23708 13.1083 8.2548 13.0899 8.2728 13.0719C8.29087 13.0539 8.30922 13.0361 8.32625 13.0173C8.3399 13.0023 8.35246 12.986 8.36563 12.9703C8.38515 12.9469 8.40466 12.9235 8.42266 12.899C8.43308 12.8848 8.4426 12.8698 8.45253 12.8551C8.47122 12.8278 8.48956 12.8004 8.50632 12.7721C8.50908 12.7674 8.51232 12.7633 8.51501 12.7586C8.52198 12.7465 8.52722 12.7339 8.53384 12.7217C8.54825 12.695 8.56246 12.6684 8.57522 12.641C8.58528 12.6194 8.59418 12.5976 8.60315 12.5758Z" fill="#29B5E8"/>
+<path id="petal 4" fill-rule="evenodd" clip-rule="evenodd" d="M9.79594 15.1724C9.43036 15.1724 9.09504 15.3017 8.83304 15.5171L4.02007 18.2958C3.29441 18.7148 3.04579 19.6427 3.46476 20.3684C3.88372 21.0941 4.81165 21.3428 5.53731 20.9238L8.2787 19.3411V22.4827C8.2787 23.3207 8.95801 24 9.79594 24C10.6339 24 11.3132 23.3207 11.3132 22.4827V16.6896C11.3132 15.8517 10.6339 15.1724 9.79594 15.1724Z" fill="#29B5E8"/>
+<path id="petal 3" fill-rule="evenodd" clip-rule="evenodd" d="M21.2272 18.2958L16.4142 15.5171C16.1522 15.3017 15.8169 15.1724 15.4513 15.1724C14.6134 15.1724 13.9341 15.8517 13.9341 16.6896V22.4827C13.9341 23.3207 14.6134 24 15.4513 24C16.2893 24 16.9686 23.3207 16.9686 22.4827V19.3411L19.71 20.9238C20.4356 21.3428 21.3636 21.0941 21.7826 20.3684C22.2015 19.6427 21.9529 18.7148 21.2272 18.2958Z" fill="#29B5E8"/>
+<path id="petal 2" fill-rule="evenodd" clip-rule="evenodd" d="M23.8219 13.5826L21.0808 12L23.8219 10.4174C24.5476 9.99843 24.7963 9.0705 24.3773 8.34484C23.9584 7.61911 23.0304 7.37049 22.3047 7.78946L17.2877 10.686C17.283 10.6887 17.2789 10.692 17.2743 10.6947C17.2459 10.7115 17.2186 10.7298 17.1912 10.7484C17.1766 10.7584 17.1615 10.7679 17.1473 10.7784C17.1228 10.7964 17.0995 10.8159 17.0761 10.8353C17.0603 10.8484 17.0441 10.8611 17.029 10.8747C17.0101 10.8917 16.9926 10.9101 16.9745 10.9282C16.9565 10.9462 16.9381 10.9638 16.921 10.9826C16.9074 10.9978 16.8948 11.014 16.8817 11.0297C16.8622 11.0532 16.8427 11.0765 16.8247 11.101C16.8143 11.1152 16.8048 11.1302 16.7947 11.1449C16.7761 11.1722 16.7578 11.1995 16.7411 11.2279C16.7383 11.2326 16.735 11.2366 16.7323 11.2414C16.7254 11.2535 16.7201 11.2661 16.7134 11.2784C16.6991 11.305 16.6849 11.3316 16.6721 11.359C16.6621 11.3805 16.6532 11.4024 16.6442 11.4242C16.6348 11.4469 16.6256 11.4697 16.6174 11.4928C16.6081 11.5188 16.6001 11.5448 16.5924 11.5711C16.5865 11.5911 16.5806 11.6112 16.5756 11.6315C16.5685 11.6595 16.5625 11.6876 16.5572 11.7159C16.5534 11.7358 16.5498 11.7557 16.5468 11.7757C16.5426 11.8033 16.5394 11.8309 16.5369 11.8586C16.5348 11.8805 16.5331 11.9025 16.5319 11.9246C16.5307 11.9497 16.5303 11.9748 16.5303 12C16.5303 12.0251 16.5307 12.0502 16.5319 12.0754C16.5331 12.0975 16.5348 12.1194 16.5369 12.1415C16.5394 12.1691 16.5426 12.1966 16.5468 12.2243C16.5498 12.2444 16.5534 12.2642 16.5572 12.2841C16.5625 12.3124 16.5685 12.3404 16.5756 12.3685C16.5806 12.3888 16.5865 12.4088 16.5924 12.4289C16.6001 12.4551 16.6081 12.4811 16.6174 12.5071C16.6256 12.5303 16.6348 12.553 16.6442 12.5757C16.6532 12.5976 16.6621 12.6194 16.6721 12.641C16.6849 12.6684 16.6991 12.6951 16.7135 12.7217C16.7201 12.7339 16.7254 12.7465 16.7323 12.7586C16.735 12.7633 16.7383 12.7675 16.741 12.7721C16.7578 12.8004 16.7761 12.8278 16.7948 12.8551C16.8048 12.8697 16.8143 12.8849 16.8247 12.899C16.8427 12.9235 16.8622 12.9469 16.8818 12.9703C16.8949 12.986 16.9074 13.0022 16.921 13.0173C16.9381 13.0361 16.9565 13.0538 16.9746 13.0719C16.9926 13.0899 17.0102 13.1082 17.029 13.1252C17.0441 13.1389 17.0603 13.1515 17.0761 13.1646C17.0995 13.1842 17.1228 13.2037 17.1473 13.2216C17.1615 13.2321 17.1766 13.2416 17.1912 13.2516C17.2186 13.2702 17.2459 13.2885 17.2743 13.3053C17.2789 13.308 17.283 13.3112 17.2877 13.314L22.3047 16.2105C23.0304 16.6295 23.9584 16.3809 24.3773 15.6552C24.7963 14.9295 24.5476 14.0015 23.8219 13.5826Z" fill="#29B5E8"/>
+<path id="petal 1" fill-rule="evenodd" clip-rule="evenodd" d="M21.7826 3.63153C21.3636 2.90587 20.4357 2.65718 19.71 3.07614L16.9686 4.65891V1.51724C16.9686 0.679312 16.2893 0 15.4513 0C14.6134 0 13.9341 0.679312 13.9341 1.51724V7.31036C13.9341 8.14836 14.6134 8.82761 15.4513 8.82761C15.8169 8.82761 16.1523 8.69823 16.4142 8.48285L21.2272 5.70408C21.9529 5.28518 22.2015 4.35718 21.7826 3.63153Z" fill="#29B5E8"/>
+</g>
+</svg>

streamlit/string_util.py

@@ -0,0 +1,203 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+#
+# 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
+import textwrap
+from typing import TYPE_CHECKING, Any, Final, cast
+
+from streamlit.errors import StreamlitAPIException
+
+if TYPE_CHECKING:
+    from streamlit.type_util import SupportsStr
+
+_ALPHANUMERIC_CHAR_REGEX: Final = re.compile(r"^[a-zA-Z0-9_&\-\. ]+$")
+
+
+def clean_text(text: SupportsStr) -> str:
+    """Convert an object to text, dedent it, and strip whitespace."""
+    return textwrap.dedent(str(text)).strip()
+
+
+def _contains_special_chars(text: str) -> bool:
+    """Check if a string contains any special chars.
+
+    Special chars in that case are all chars that are not
+    alphanumeric, underscore, hyphen or whitespace.
+    """
+    return re.match(_ALPHANUMERIC_CHAR_REGEX, text) is None if text else False
+
+
+def is_emoji(text: str) -> bool:
+    """Check if input string is a valid emoji."""
+    if not _contains_special_chars(text):
+        return False
+
+    from streamlit.emojis import ALL_EMOJIS
+
+    return text.replace("\U0000fe0f", "") in ALL_EMOJIS
+
+
+def is_material_icon(maybe_icon: str) -> bool:
+    """Check if input string is a valid Material icon."""
+    from streamlit.material_icon_names import ALL_MATERIAL_ICONS
+
+    return maybe_icon in ALL_MATERIAL_ICONS
+
+
+def validate_icon_or_emoji(icon: str | None) -> str:
+    """Validate an icon or emoji and return it in normalized format if valid."""
+    if icon is not None and icon.startswith(":material"):
+        return validate_material_icon(icon)
+    return validate_emoji(icon)
+
+
+def validate_emoji(maybe_emoji: str | None) -> str:
+    if maybe_emoji is None:
+        return ""
+
+    elif is_emoji(maybe_emoji):
+        return maybe_emoji
+    else:
+        raise StreamlitAPIException(
+            f'The value "{maybe_emoji}" is not a valid emoji. Shortcodes are not allowed, please use a single character instead.'
+        )
+
+
+def validate_material_icon(maybe_material_icon: str | None) -> str:
+    """Validate a Material icon shortcode and return the icon in
+    normalized format if valid."""
+
+    supported_icon_packs = [
+        "material",
+    ]
+
+    if maybe_material_icon is None:
+        return ""
+
+    icon_regex = r"^\s*:(.+)\/(.+):\s*$"
+    icon_match = re.match(icon_regex, maybe_material_icon)
+    # Since our markdown processing needs to change the `/` to `_` in order to
+    # correctly render the icon, we need to add a zero-width space before the
+    # `/` to avoid this transformation here.
+    invisible_white_space = "\u200b"
+
+    if not icon_match:
+        raise StreamlitAPIException(
+            f'The value `"{maybe_material_icon.replace("/", invisible_white_space + "/")}"` is not a valid Material icon. '
+            f"Please use a Material icon shortcode like **`:material{invisible_white_space}/thumb_up:`**"
+        )
+
+    pack_name, icon_name = icon_match.groups()
+
+    if (
+        pack_name not in supported_icon_packs
+        or not icon_name
+        or not is_material_icon(icon_name)
+    ):
+        raise StreamlitAPIException(
+            f'The value `"{maybe_material_icon.replace("/", invisible_white_space + "/")}"` is not a valid Material icon.'
+            f" Please use a Material icon shortcode like **`:material{invisible_white_space}/thumb_up:`**. "
+        )
+
+    return f":{pack_name}/{icon_name}:"
+
+
+def extract_leading_emoji(text: str) -> tuple[str, str]:
+    """Return a tuple containing the first emoji found in the given string and
+    the rest of the string (minus an optional separator between the two).
+    """
+
+    if not _contains_special_chars(text):
+        # If the string only contains basic alphanumerical chars and/or
+        # underscores, hyphen & whitespaces, then it's guaranteed that there
+        # is no emoji in the string.
+        return "", text
+
+    from streamlit.emojis import EMOJI_EXTRACTION_REGEX
+
+    re_match = re.search(EMOJI_EXTRACTION_REGEX, text)
+    if re_match is None:
+        return "", text
+
+    # This cast to Any+type annotation weirdness is done because
+    # cast(re.Match[str], ...) explodes at runtime since Python interprets it
+    # as an attempt to index into re.Match instead of as a type annotation.
+    re_match: re.Match[str] = cast(Any, re_match)
+    return re_match.group(1), re_match.group(2)
+
+
+def max_char_sequence(string: str, char: str) -> int:
+    """Returns the count of the max sequence of a given char in a string."""
+    max_sequence = 0
+    current_sequence = 0
+    for c in string:
+        if c == char:
+            current_sequence += 1
+            max_sequence = max(max_sequence, current_sequence)
+        else:
+            current_sequence = 0
+
+    return max_sequence
+
+
+TEXTCHARS: Final = bytearray(
+    {7, 8, 9, 10, 12, 13, 27} | set(range(0x20, 0x100)) - {0x7F}
+)
+
+
+def is_binary_string(inp: bytes) -> bool:
+    """Guess if an input bytesarray can be encoded as a string."""
+    # From https://stackoverflow.com/a/7392391
+    return bool(inp.translate(None, TEXTCHARS))
+
+
+def simplify_number(num: int) -> str:
+    """Simplifies number into Human readable format, returns str"""
+    num_converted = float(f"{num:.2g}")
+    magnitude = 0
+    while abs(num_converted) >= 1000:
+        magnitude += 1
+        num_converted /= 1000.0
+    return "{}{}".format(
+        f"{num_converted:f}".rstrip("0").rstrip("."),
+        ["", "k", "m", "b", "t"][magnitude],
+    )
+
+
+_OBJ_MEM_ADDRESS: Final = re.compile(
+    r"^\<[a-zA-Z_]+[a-zA-Z0-9<>._ ]* at 0x[0-9a-f]+\>$"
+)
+
+
+def is_mem_address_str(string):
+    """Returns True if the string looks like <foo blarg at 0x15ee6f9a0>."""
+    if _OBJ_MEM_ADDRESS.match(string):
+        return True
+
+    return False
+
+
+def to_snake_case(camel_case_str: str) -> str:
+    """Converts UpperCamelCase and lowerCamelCase to snake_case.
+
+    Examples
+    --------
+        fooBar -> foo_bar
+        BazBang -> baz_bang
+
+    """
+    s1 = re.sub("(.)([A-Z][a-z]+)", r"\1_\2", camel_case_str)
+    return re.sub("([a-z0-9])([A-Z])", r"\1_\2", s1).lower()

streamlit/temporary_directory.py

@@ -0,0 +1,56 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+#
+# 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 shutil
+import tempfile
+
+from streamlit import util
+
+# We provide our own context manager for temporary directory that wraps
+# tempfile.mkdtemp
+
+
+class TemporaryDirectory:
+    """Temporary directory context manager.
+
+    Creates a temporary directory that exists within the context manager scope.
+    It returns the path to the created directory.
+    Wrapper on top of tempfile.mkdtemp.
+
+    Parameters
+    ----------
+    suffix : str or None
+        Suffix to the filename.
+    prefix : str or None
+        Prefix to the filename.
+    dir : str or None
+        Enclosing directory.
+
+    """
+
+    def __init__(self, *args, **kwargs):
+        self._args = args
+        self._kwargs = kwargs
+
+    def __repr__(self) -> str:
+        return util.repr_(self)
+
+    def __enter__(self):
+        self._path = tempfile.mkdtemp(*self._args, **self._kwargs)
+        return self._path
+
+    def __exit__(self, exc_type, exc_value, exc_traceback):
+        shutil.rmtree(self._path)

streamlit/testing/__init__.py

@@ -0,0 +1,13 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+#
+# 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/testing/v1/__init__.py

@@ -0,0 +1,17 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+#
+# 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 streamlit.testing.v1.app_test import AppTest
+
+__all__ = ["AppTest"]