streamlit-nightly 1.38.1.dev20240908__py2.py3-none-any.whl → 1.38.1.dev20240910__py2.py3-none-any.whl

streamlit/string_util.py

@@ -26,11 +26,6 @@ if TYPE_CHECKING:
 _ALPHANUMERIC_CHAR_REGEX: Final = re.compile(r"^[a-zA-Z0-9_&\-\. ]+$")
 
 
-def decode_ascii(string: bytes) -> str:
-    """Decodes a string as ascii."""
-    return string.decode("ascii")
-
-
 def clean_text(text: SupportsStr) -> str:
     """Convert an object to text, dedent it, and strip whitespace."""
     return textwrap.dedent(str(text)).strip()
@@ -204,3 +199,16 @@ def probably_contains_html_tags(s: str) -> bool:
     Note that false positives/negatives are possible, so this function should not be
     used in contexts where complete correctness is required."""
     return bool(_RE_CONTAINS_HTML.search(s))
+
+
+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/time_util.py

@@ -18,7 +18,7 @@ import math
 from datetime import date, timedelta
 from typing import Literal, overload
 
-from streamlit.errors import MarkdownFormattedException, StreamlitAPIException
+from streamlit.errors import StreamlitAPIException, StreamlitBadTimeStringError
 
 
 def adjust_years(input_date: date, years: int) -> date:
@@ -38,17 +38,6 @@ def adjust_years(input_date: date, years: int) -> date:
         ) from err
 
 
-class BadTimeStringError(StreamlitAPIException):
-    """Raised when a bad time string argument is passed."""
-
-    def __init__(self, t: str):
-        MarkdownFormattedException.__init__(
-            self,
-            "Time string doesn't look right. It should be formatted as"
-            f"`'1d2h34m'` or `2 days`, for example. Got: {t}",
-        )
-
-
 @overload
 def time_to_seconds(
     t: float | timedelta | str | None, *, coerce_none_to_inf: Literal[False]
@@ -77,10 +66,10 @@ def time_to_seconds(
             seconds: float = pd.Timedelta(t).total_seconds()
 
             if np.isnan(seconds):
-                raise BadTimeStringError(t)
+                raise StreamlitBadTimeStringError(t)
 
             return seconds
         except ValueError as ex:
-            raise BadTimeStringError(t) from ex
+            raise StreamlitBadTimeStringError(t) from ex
 
     return t

streamlit/util.py

@@ -19,16 +19,8 @@ from __future__ import annotations
 import dataclasses
 import functools
 import hashlib
-import os
-import subprocess
 import sys
-from typing import Any, Callable, Final, Iterable, Mapping, TypeVar
-
-from streamlit import env_util
-
-# URL of Streamlit's help page.
-HELP_DOC: Final = "https://docs.streamlit.io/"
-FLOAT_EQUALITY_EPSILON: Final[float] = 0.000000000005
+from typing import Any, Callable
 
 # Due to security issue in md5 and sha1, usedforsecurity
 # argument is added to hashlib for python versions higher than 3.8
@@ -50,60 +42,6 @@ def memoize(func: Callable[..., Any]) -> Callable[..., Any]:
     return wrapped_func
 
 
-def open_browser(url: str) -> None:
-    """Open a web browser pointing to a given URL.
-
-    We use this function instead of Python's `webbrowser` module because this
-    way we can capture stdout/stderr to avoid polluting the terminal with the
-    browser's messages. For example, Chrome always prints things like "Created
-    new window in existing browser session", and those get on the user's way.
-
-    url : str
-        The URL. Must include the protocol.
-
-    """
-    # Treat Windows separately because:
-    # 1. /dev/null doesn't exist.
-    # 2. subprocess.Popen(['start', url]) doesn't actually pop up the
-    #    browser even though 'start url' works from the command prompt.
-    # Fun!
-    # Also, use webbrowser if we are on Linux and xdg-open is not installed.
-    #
-    # We don't use the webbrowser module on Linux and Mac because some browsers
-    # (ahem... Chrome) always print "Opening in existing browser session" to
-    # the terminal, which is spammy and annoying. So instead we start the
-    # browser ourselves and send all its output to /dev/null.
-
-    if env_util.IS_WINDOWS:
-        _open_browser_with_webbrowser(url)
-        return
-    if env_util.IS_LINUX_OR_BSD:
-        if env_util.is_executable_in_path("xdg-open"):
-            _open_browser_with_command("xdg-open", url)
-            return
-        _open_browser_with_webbrowser(url)
-        return
-    if env_util.IS_DARWIN:
-        _open_browser_with_command("open", url)
-        return
-
-    import platform
-
-    raise Error('Cannot open browser in platform "%s"' % platform.system())
-
-
-def _open_browser_with_webbrowser(url: str) -> None:
-    import webbrowser
-
-    webbrowser.open(url)
-
-
-def _open_browser_with_command(command: str, url: str) -> None:
-    cmd_line = [command, url]
-    with open(os.devnull, "w") as devnull:
-        subprocess.Popen(cmd_line, stdout=devnull, stderr=subprocess.STDOUT)
-
-
 def repr_(self: Any) -> str:
     """A clean repr for a class, excluding both values that are likely defaults,
     and those explicitly default for dataclasses.
@@ -127,46 +65,6 @@ def repr_(self: Any) -> str:
     return f"{classname}({field_reprs})"
 
 
-_Value = TypeVar("_Value")
-
-
-def index_(iterable: Iterable[_Value], x: _Value) -> int:
-    """Return zero-based index of the first item whose value is equal to x.
-    Raises a ValueError if there is no such item.
-
-    We need a custom implementation instead of the built-in list .index() to
-    be compatible with NumPy array and Pandas Series.
-
-    Parameters
-    ----------
-    iterable : list, tuple, numpy.ndarray, pandas.Series
-    x : Any
-
-    Returns
-    -------
-    int
-    """
-    for i, value in enumerate(iterable):
-        if x == value:
-            return i
-        elif isinstance(value, float) and isinstance(x, float):
-            if abs(x - value) < FLOAT_EQUALITY_EPSILON:
-                return i
-    raise ValueError(f"{str(x)} is not in iterable")
-
-
-_Key = TypeVar("_Key", bound=str)
-
-
-def lower_clean_dict_keys(dict: Mapping[_Key, _Value]) -> dict[str, _Value]:
-    return {k.lower().strip(): v for k, v in dict.items()}
-
-
-# TODO: Move this into errors.py? Replace with StreamlitAPIException?
-class Error(Exception):
-    pass
-
-
 def calc_md5(s: bytes | str) -> str:
     """Return the md5 hash of the given string."""
     h = hashlib.new("md5", **HASHLIB_KWARGS)
@@ -175,27 +73,3 @@ def calc_md5(s: bytes | str) -> str:
 
     h.update(b)
     return h.hexdigest()
-
-
-def exclude_keys_in_dict(
-    d: dict[str, Any], keys_to_exclude: list[str]
-) -> dict[str, Any]:
-    """Returns new object but without keys defined in keys_to_exclude"""
-    return {
-        key: value for key, value in d.items() if key.lower() not in keys_to_exclude
-    }
-
-
-def extract_key_query_params(
-    query_params: dict[str, list[str]], param_key: str
-) -> set[str]:
-    """Extracts key (case-insensitive) query params from Dict, and returns them as Set of str."""
-    return {
-        item.lower()
-        for sublist in [
-            [value.lower() for value in query_params[key]]
-            for key in query_params.keys()
-            if key.lower() == param_key and query_params.get(key)
-        ]
-        for item in sublist
-    }

streamlit/watcher/local_sources_watcher.py

@@ -20,8 +20,8 @@ from pathlib import Path
 from typing import TYPE_CHECKING, Any, Callable, Final, NamedTuple
 
 from streamlit import config, file_util
-from streamlit.folder_black_list import FolderBlackList
 from streamlit.logger import get_logger
+from streamlit.watcher.folder_black_list import FolderBlackList
 from streamlit.watcher.path_watcher import (
     NoOpPathWatcher,
     get_default_path_watcher_class,

streamlit/web/bootstrap.py

@@ -20,7 +20,7 @@ import signal
 import sys
 from typing import Any, Final
 
-from streamlit import cli_util, config, env_util, file_util, net_util, secrets, util
+from streamlit import cli_util, config, env_util, file_util, net_util, secrets
 from streamlit.config import CONFIG_FILENAMES
 from streamlit.git_util import MIN_GIT_VERSION, GitRepo
 from streamlit.logger import get_logger
@@ -130,7 +130,7 @@ def _on_server_start(server: Server) -> None:
         else:
             addr = "localhost"
 
-        util.open_browser(server_util.get_url(addr))
+        cli_util.open_browser(server_util.get_url(addr))
 
     # Schedule the browser to open on the main thread.
     asyncio.get_running_loop().call_soon(maybe_open_browser)

streamlit/web/cli.py

@@ -176,9 +176,9 @@ def main_version():
 def main_docs():
     """Show help in browser."""
     click.echo("Showing help page in browser...")
-    from streamlit import util
+    from streamlit import cli_util
 
-    util.open_browser("https://docs.streamlit.io")
+    cli_util.open_browser("https://docs.streamlit.io")
 
 
 @main.command("hello")

{streamlit_nightly-1.38.1.dev20240908.dist-info → streamlit_nightly-1.38.1.dev20240910.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: streamlit-nightly
-Version: 1.38.1.dev20240908
+Version: 1.38.1.dev20240910
 Summary: A faster way to build and share data apps
 Home-page: https://streamlit.io
 Author: Snowflake Inc