streamlit 1.49.1__py3-none-any.whl → 1.50.0__py3-none-any.whl

streamlit/elements/widgets/audio_input.py

@@ -35,6 +35,7 @@ from streamlit.elements.lib.utils import (
     to_key,
 )
 from streamlit.elements.widgets.file_uploader import _get_upload_files
+from streamlit.errors import StreamlitAPIException
 from streamlit.proto.AudioInput_pb2 import AudioInput as AudioInputProto
 from streamlit.proto.Common_pb2 import FileUploaderState as FileUploaderStateProto
 from streamlit.proto.Common_pb2 import UploadedFileInfo as UploadedFileInfoProto
@@ -54,6 +55,9 @@ if TYPE_CHECKING:
 
 SomeUploadedAudioFile: TypeAlias = Union[UploadedFile, DeletedFile, None]
 
+# Allowed sample rates for audio recording
+ALLOWED_SAMPLE_RATES = {8000, 11025, 16000, 22050, 24000, 32000, 44100, 48000}
+
 
 @dataclass
 class AudioInputSerde:
@@ -90,6 +94,7 @@ class AudioInputMixin:
         self,
         label: str,
         *,
+        sample_rate: int | None = 16000,
         key: Key | None = None,
         help: str | None = None,
         on_change: WidgetCallback | None = None,
@@ -125,6 +130,15 @@ class AudioInputMixin:
             .. |st.markdown| replace:: ``st.markdown``
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
 
+        sample_rate : int or None
+            The target sample rate for the audio recording in Hz.
+            This defaults to 16000 Hz, which is optimal for speech recognition.
+
+            The following sample rates are supported: 8000, 11025, 16000,
+            22050, 24000, 32000, 44100, or 48000. If this is ``None``, the
+            widget uses the browser's default sample rate (typically 44100 or
+            48000 Hz).
+
         key : str or int
             An optional string or integer to use as the unique key for the widget.
             If this is omitted, a key will be generated for the widget
@@ -185,6 +199,10 @@ class AudioInputMixin:
 
         Examples
         --------
+        *Example 1:* Record a voice message and play it back.*
+
+        The default sample rate of 16000 Hz is optimal for speech recognition.
+
         >>> import streamlit as st
         >>>
         >>> audio_value = st.audio_input("Record a voice message")
@@ -196,10 +214,34 @@ class AudioInputMixin:
            https://doc-audio-input.streamlit.app/
            height: 260px
 
+        *Example 2:* Record high-fidelity audio and play it back.*
+
+        Higher sample rates can create higher-quality, larger audio files. This
+        might require a nicer microphone to fully appreciate the difference.
+
+        >>> import streamlit as st
+        >>>
+        >>> audio_value = st.audio_input("Record high quality audio", sample_rate=48000)
+        >>>
+        >>> if audio_value:
+        ...     st.audio(audio_value)
+
+        .. output::
+           https://doc-audio-input-high-rate.streamlit.app/
+           height: 260px
+
         """
+        # Validate sample_rate parameter
+        if sample_rate is not None and sample_rate not in ALLOWED_SAMPLE_RATES:
+            raise StreamlitAPIException(
+                f"Invalid sample_rate: {sample_rate}. "
+                f"Must be one of {sorted(ALLOWED_SAMPLE_RATES)} Hz, or None for browser default."
+            )
+
         ctx = get_script_run_ctx()
         return self._audio_input(
             label=label,
+            sample_rate=sample_rate,
             key=key,
             help=help,
             on_change=on_change,
@@ -214,6 +256,7 @@ class AudioInputMixin:
     def _audio_input(
         self,
         label: str,
+        sample_rate: int | None = 16000,
         key: Key | None = None,
         help: str | None = None,
         on_change: WidgetCallback | None = None,
@@ -239,6 +282,7 @@ class AudioInputMixin:
         element_id = compute_and_register_element_id(
             "audio_input",
             user_key=key,
+            key_as_main_identity=False,
             dg=self.dg,
             label=label,
             help=help,
@@ -254,6 +298,10 @@ class AudioInputMixin:
             label_visibility
         )
 
+        # Set sample_rate in protobuf if specified
+        if sample_rate is not None:
+            audio_input_proto.sample_rate = sample_rate
+
         if label and help is not None:
             audio_input_proto.help = dedent(help)
 

streamlit/elements/widgets/button.py

@@ -188,6 +188,12 @@ class ButtonMixin:
             In both cases, if the contents of the button are wider than the
             parent container, the contents will line wrap.
 
+            .. 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 button. This can be one of the following:
 
@@ -201,12 +207,6 @@ class ButtonMixin:
               the parent container, the width of the button matches 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"``.
-
         Returns
         -------
         bool
@@ -432,6 +432,12 @@ class ButtonMixin:
             In both cases, if the contents of the button are wider than the
             parent container, the contents will line wrap.
 
+            .. 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 download button. This can be one of the following:
 
@@ -445,12 +451,6 @@ class ButtonMixin:
               the parent container, the width of the button matches 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"``.
-
         Returns
         -------
         bool
@@ -680,6 +680,12 @@ class ButtonMixin:
             In both cases, if the contents of the button are wider than the
             parent container, the contents will line wrap.
 
+            .. 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 link button. This can be one of the following:
 
@@ -693,12 +699,6 @@ class ButtonMixin:
               the parent container, the width of the button matches 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"``.
-
         Example
         -------
         >>> import streamlit as st
@@ -812,6 +812,12 @@ class ButtonMixin:
             The default is ``True`` for page links in the sidebar and ``False``
             for those in the main app.
 
+            .. 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 page-link button. This can be one of the following:
 
@@ -825,12 +831,6 @@ class ButtonMixin:
               the parent container, the width of the button matches 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"``.
-
         Example
         -------
         Consider the following example given this file structure:
@@ -914,6 +914,7 @@ class ButtonMixin:
         element_id = compute_and_register_element_id(
             "download_button",
             user_key=key,
+            key_as_main_identity=True,
             dg=self.dg,
             label=label,
             icon=icon,
@@ -1119,8 +1120,9 @@ class ButtonMixin:
         # Only the form submitter button needs a form ID at the moment.
         form_id = current_form_id(self.dg) if is_form_submitter else ""
         element_id = compute_and_register_element_id(
-            "button",
+            "form_submit_button" if is_form_submitter else "button",
             user_key=key,
+            key_as_main_identity=True,
             dg=self.dg,
             label=label,
             icon=icon,

streamlit/elements/widgets/button_group.py

@@ -1047,6 +1047,7 @@ class ButtonGroupMixin:
             # "feedback" in errors
             "feedback" if style == "borderless" else style,
             user_key=key,
+            key_as_main_identity=False,
             dg=self.dg,
             options=formatted_options,
             default=default,

streamlit/elements/widgets/camera_input.py

@@ -234,6 +234,7 @@ class CameraInputMixin:
         element_id = compute_and_register_element_id(
             "camera_input",
             user_key=key,
+            key_as_main_identity=False,
             dg=self.dg,
             label=label,
             help=help,

streamlit/elements/widgets/chat.py

@@ -624,6 +624,7 @@ class ChatMixin:
         element_id = compute_and_register_element_id(
             "chat_input",
             user_key=key,
+            key_as_main_identity=False,
             dg=self.dg,
             placeholder=placeholder,
             max_chars=max_chars,

streamlit/elements/widgets/checkbox.py

@@ -342,6 +342,7 @@ class CheckboxMixin:
         element_id = compute_and_register_element_id(
             "toggle" if type == CheckboxProto.StyleType.TOGGLE else "checkbox",
             user_key=key,
+            key_as_main_identity=True,
             dg=self.dg,
             label=label,
             value=bool(value),

streamlit/elements/widgets/color_picker.py

@@ -219,6 +219,7 @@ class ColorPickerMixin:
         element_id = compute_and_register_element_id(
             "color_picker",
             user_key=key,
+            key_as_main_identity=False,
             dg=self.dg,
             label=label,
             value=str(value),

streamlit/elements/widgets/data_editor.py

@@ -711,6 +711,11 @@ class DataEditorMixin:
             this is ``False``, Streamlit sets the data editor's width according
             to ``width``.
 
+            .. deprecated::
+                ``use_container_width`` is deprecated and will be removed in a
+                future release. For ``use_container_width=True``, use
+                ``width="stretch"``.
+
         hide_index : bool or None
             Whether to hide the index column(s). If ``hide_index`` is ``None``
             (default), the visibility of index columns is automatically
@@ -793,11 +798,6 @@ class DataEditorMixin:
             is ``None`` (default), Streamlit will use a default row height,
             which fits one line of text.
 
-        .. deprecated::
-            ``use_container_width`` is deprecated and will be removed in a
-            future release. For ``use_container_width=True``, use
-            ``width="stretch"``.
-
         Returns
         -------
         pandas.DataFrame, pandas.Series, pyarrow.Table, numpy.ndarray, list, set, tuple, or dict.
@@ -1028,6 +1028,7 @@ class DataEditorMixin:
         element_id = compute_and_register_element_id(
             "data_editor",
             user_key=key,
+            key_as_main_identity=False,
             dg=self.dg,
             data=arrow_bytes,
             width=width,

streamlit/elements/widgets/file_uploader.py

@@ -488,6 +488,7 @@ class FileUploaderMixin:
         element_id = compute_and_register_element_id(
             "file_uploader",
             user_key=key,
+            key_as_main_identity=False,
             dg=self.dg,
             label=label,
             type=type,

streamlit/elements/widgets/multiselect.py

@@ -492,6 +492,16 @@ class MultiSelectMixin:
         element_id = compute_and_register_element_id(
             widget_name,
             user_key=key,
+            # Treat the provided key as the main identity. Only include
+            # changes to the options, accept_new_options, and max_selections
+            # in the identity computation as those can invalidate the
+            # current selection.
+            key_as_main_identity={
+                "options",
+                "max_selections",
+                "accept_new_options",
+                "format_func",
+            },
             dg=self.dg,
             label=label,
             options=formatted_options,

streamlit/elements/widgets/number_input.py

@@ -452,6 +452,9 @@ class NumberInputMixin:
         element_id = compute_and_register_element_id(
             "number_input",
             user_key=key,
+            # Ensure stable ID when key is provided; explicitly whitelist parameters
+            # that might invalidate the current widget state.
+            key_as_main_identity={"min_value", "max_value", "step"},
             dg=self.dg,
             label=label,
             min_value=min_value,

streamlit/elements/widgets/radio.py

@@ -369,6 +369,7 @@ class RadioMixin:
         element_id = compute_and_register_element_id(
             "radio",
             user_key=key,
+            key_as_main_identity=False,
             dg=self.dg,
             label=label,
             options=[str(format_func(option)) for option in opt],

streamlit/elements/widgets/select_slider.py

@@ -377,6 +377,7 @@ class SelectSliderMixin:
         element_id = compute_and_register_element_id(
             "select_slider",
             user_key=key,
+            key_as_main_identity=False,
             dg=self.dg,
             label=label,
             options=[str(format_func(option)) for option in opt],

streamlit/elements/widgets/selectbox.py

@@ -541,6 +541,10 @@ class SelectboxMixin:
         element_id = compute_and_register_element_id(
             "selectbox",
             user_key=key,
+            # Treat the provided key as the main identity. Only include
+            # the options and accept_new_options in the identity computation
+            # as those can invalidate the current selection.
+            key_as_main_identity={"options", "accept_new_options", "format_func"},
             dg=self.dg,
             label=label,
             options=formatted_options,

streamlit/elements/widgets/slider.py

@@ -680,6 +680,7 @@ class SliderMixin:
         element_id = compute_and_register_element_id(
             "slider",
             user_key=key,
+            key_as_main_identity=False,
             dg=self.dg,
             label=label,
             min_value=min_value,

streamlit/elements/widgets/text_widgets.py

@@ -328,6 +328,9 @@ class TextWidgetsMixin:
         element_id = compute_and_register_element_id(
             "text_input",
             user_key=key,
+            # Explicitly whitelist max_chars to make sure the ID changes when it changes
+            # since the widget value might become invalid based on a different max_chars
+            key_as_main_identity={"max_chars"},
             dg=self.dg,
             label=label,
             value=value,
@@ -642,6 +645,9 @@ class TextWidgetsMixin:
         element_id = compute_and_register_element_id(
             "text_area",
             user_key=key,
+            # Explicitly whitelist max_chars to make sure the ID changes when it changes
+            # since the widget value might become invalid based on a different max_chars
+            key_as_main_identity={"max_chars"},
             dg=self.dg,
             label=label,
             value=value,

streamlit/elements/widgets/time_widgets.py

@@ -529,6 +529,9 @@ class TimeWidgetsMixin:
         element_id = compute_and_register_element_id(
             "time_input",
             user_key=key,
+            # Ensure stable ID when key is provided; only whitelist step since it
+            # affects the selection granularity and available options.
+            key_as_main_identity={"step"},
             dg=self.dg,
             label=label,
             value=parsed_time if isinstance(value, (datetime, time)) else value,
@@ -911,6 +914,12 @@ class TimeWidgetsMixin:
         element_id = compute_and_register_element_id(
             "date_input",
             user_key=key,
+            # Ensure stable ID when key is provided; explicitly whitelist parameters
+            # that might invalidate the current widget state.
+            # format should be supported. However, there is a bug in baseweb where
+            # changing the format dynamically leads to a wrongly formatted date.
+            # So, we whitelist it for now until we migrate this away from baseweb.
+            key_as_main_identity={"min_value", "max_value", "format"},
             dg=self.dg,
             label=label,
             value=parsed,

streamlit/elements/write.py

@@ -37,7 +37,6 @@ from typing import (
 
 from streamlit import dataframe_util, type_util
 from streamlit.errors import StreamlitAPIException
-from streamlit.logger import get_logger
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.string_util import (
     is_mem_address_str,
@@ -56,7 +55,6 @@ HELP_TYPES: Final[tuple[type[Any], ...]] = (
     types.ModuleType,
 )
 
-_LOGGER: Final = get_logger(__name__)
 
 _TEXT_CURSOR: Final = " ▏"
 
@@ -254,7 +252,7 @@ class WriteMixin:
         return written_content
 
     @gather_metrics("write")
-    def write(self, *args: Any, unsafe_allow_html: bool = False, **kwargs: Any) -> None:
+    def write(self, *args: Any, unsafe_allow_html: bool = False) -> None:
         """Displays arguments in the app.
 
         This is the Swiss Army knife of Streamlit commands: it does different
@@ -323,13 +321,6 @@ class WriteMixin:
                 If you only want to insert HTML or CSS without Markdown text,
                 we recommend using ``st.html`` instead.
 
-        **kwargs : any
-            Keyword arguments. Not used.
-
-        .. deprecated::
-            ``**kwargs`` is deprecated and will be removed in a later version.
-            Use other, more specific Streamlit commands to pass additional
-            keyword arguments.
 
         Returns
         -------
@@ -400,13 +391,6 @@ class WriteMixin:
             height: 300px
 
         """
-        if kwargs:
-            _LOGGER.warning(
-                'Invalid arguments were passed to "st.write" function. Support for '
-                "passing such unknown keywords arguments will be dropped in future. "
-                "Invalid arguments were: %s",
-                kwargs,
-            )
 
         if len(args) == 1 and isinstance(args[0], str):
             # Optimization: If there is only one arg, and it's a string,

streamlit/git_util.py

@@ -16,21 +16,50 @@ from __future__ import annotations
 
 import os
 import re
-from typing import TYPE_CHECKING, cast
+from typing import TYPE_CHECKING, Final, cast
 
 from streamlit import util
+from streamlit.logger import get_logger
 
 if TYPE_CHECKING:
     from git import Commit, Remote, RemoteReference, Repo
 
-# Github has two URLs, one that is https and one that is ssh
-GITHUB_HTTP_URL = r"^https://(www\.)?github.com/(.+)/(.+)(?:.git)?$"
-GITHUB_SSH_URL = r"^git@github.com:(.+)/(.+)(?:.git)?$"
+_LOGGER: Final = get_logger(__name__)
+
+# Github repo extractor: match owner/repo for https/ssh/scp forms, with optional
+# userinfo/port/trailing slash. This is just to extract the repo name, not validate the URL.
+_GITHUB_URL_PATTERN: Final = re.compile(
+    r"github\.com(?::\d+)?[/:]([^/]+)/([^/]+?)(?:\.git)?/?$"
+)
 
 # We don't support git < 2.7, because we can't get repo info without
 # talking to the remote server, which results in the user being prompted
 # for credentials.
-MIN_GIT_VERSION = (2, 7, 0)
+_MIN_GIT_VERSION: Final = (2, 7, 0)
+
+
+def _extract_github_repo_from_url(url: str) -> str | None:
+    """Extract the ``owner/repo`` from a GitHub remote URL.
+
+    This supports HTTPS and SSH URL forms including optional user info, port,
+    trailing slash, and ``.git`` suffix. Validation of the scheme is not
+    performed; we only extract if the URL contains ``github.com`` and ends with
+    a path of the shape ``owner/repo``.
+
+    Parameters
+    ----------
+    url
+        The remote URL string.
+
+    Returns
+    -------
+    str | None
+        The extracted ``owner/repo`` if found; otherwise ``None``.
+    """
+    match = _GITHUB_URL_PATTERN.search(url.strip())
+    if match is None:
+        return None
+    return f"{match.group(1)}/{match.group(2)}"
 
 
 class GitRepo:
@@ -40,6 +69,7 @@ class GitRepo:
         # If we have a valid repo, git_version will be a tuple
         # of 3+ ints: (major, minor, patch, possible_additional_patch_number)
         self.git_version: tuple[int, ...] | None = None
+        self.module: str = ""
 
         try:
             import git
@@ -47,26 +77,31 @@ class GitRepo:
             self.repo = git.Repo(path, search_parent_directories=True)
             self.git_version = self.repo.git.version_info
 
-            if self.git_version is not None and self.git_version >= MIN_GIT_VERSION:
+            if self.git_version is not None and self.git_version >= _MIN_GIT_VERSION:
                 git_root = self.repo.git.rev_parse("--show-toplevel")
                 self.module = os.path.relpath(path, git_root)
         except Exception:
-            # The git repo must be invalid for the following reasons:
-            #  * git binary or GitPython not installed
-            #  * No .git folder
-            #  * Corrupted .git folder
-            #  * Path is invalid
+            _LOGGER.debug(
+                "Did not find a git repo at %s. This is expected if this isn't a git repo, but could "
+                "also fail for other reasons: "
+                "1) git binary or GitPython not installed "
+                "2) No .git folder "
+                "3) Corrupted .git folder "
+                "4) Path is invalid.",
+                path,
+                exc_info=True,
+            )
             self.repo = None
 
     def __repr__(self) -> str:
         return util.repr_(self)
 
     def is_valid(self) -> bool:
-        """True if there's a git repo here, and git.version >= MIN_GIT_VERSION."""
+        """True if there's a git repo here, and git.version >= _MIN_GIT_VERSION."""
         return (
             self.repo is not None
             and self.git_version is not None
-            and self.git_version >= MIN_GIT_VERSION
+            and self.git_version >= _MIN_GIT_VERSION
         )
 
     @property
@@ -129,50 +164,37 @@ class GitRepo:
         remote_name, *branch = tracking_branch.name.split("/")
         branch_name = "/".join(branch)
 
-        return self.repo.remote(remote_name), branch_name
-
-    def is_github_repo(self) -> bool:
-        if not self.is_valid():
-            return False
-
-        remote_info = self.get_tracking_branch_remote()
-        if remote_info is None:
-            return False
-
-        remote, _branch = remote_info
-
-        for url in remote.urls:
-            if (
-                re.match(GITHUB_HTTP_URL, url) is not None
-                or re.match(GITHUB_SSH_URL, url) is not None
-            ):
-                return True
-
-        return False
+        try:
+            return self.repo.remote(remote_name), branch_name
+        except Exception:
+            _LOGGER.debug("Failed to resolve remote %s", remote_name, exc_info=True)
+            return None
 
     def get_repo_info(self) -> tuple[str, str, str] | None:
         if not self.is_valid():
+            _LOGGER.debug(
+                "No valid git information found. Git version: %s", self.git_version
+            )
             return None
 
         remote_info = self.get_tracking_branch_remote()
         if remote_info is None:
+            _LOGGER.debug("No tracking remote branch found for the git repo.")
             return None
 
         remote, branch = remote_info
-
+        remote_urls = list(remote.urls)
         repo = None
-        for url in remote.urls:
-            https_matches = re.match(GITHUB_HTTP_URL, url)
-            ssh_matches = re.match(GITHUB_SSH_URL, url)
-            if https_matches is not None:
-                repo = f"{https_matches.group(2)}/{https_matches.group(3)}"
-                break
-
-            if ssh_matches is not None:
-                repo = f"{ssh_matches.group(1)}/{ssh_matches.group(2)}"
+        for url in remote_urls:
+            repo = _extract_github_repo_from_url(url)
+            if repo is not None:
                 break
 
         if repo is None:
+            _LOGGER.debug(
+                "Unable to determine repo name from configured remote URLs. URLs: %s",
+                remote_urls,
+            )
             return None
 
         return repo, branch, self.module