streamlit 1.48.0__py3-none-any.whl → 1.49.0__py3-none-any.whl

streamlit/elements/toast.py

@@ -14,9 +14,9 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, cast
+from typing import TYPE_CHECKING, Literal, cast
 
-from streamlit.errors import StreamlitAPIException
+from streamlit.errors import StreamlitAPIException, StreamlitValueError
 from streamlit.proto.Toast_pb2 import Toast as ToastProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.string_util import clean_text, validate_icon_or_emoji
@@ -41,6 +41,7 @@ class ToastMixin:
         body: SupportsStr,
         *,  # keyword-only args:
         icon: str | None = None,
+        duration: Literal["short", "long", "infinite"] | int = "short",
     ) -> DeltaGenerator:
         """Display a short message, known as a notification "toast".
         The toast appears in the app's top-right corner and disappears after four seconds.
@@ -79,16 +80,91 @@ class ToastMixin:
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
 
+        duration : "short", "long", "infinite", or int
+            The time to display the toast message. This can be one of the
+            following:
 
-        Example
-        -------
+            - ``"short"`` (default): Displays for 4 seconds.
+            - ``"long"``: Displays for 10 seconds.
+            - ``"infinite"``: Shows the toast until the user dismisses it.
+            - An integer: Displays for the specified number of seconds.
+
+        Examples
+        --------
+        **Example 1: Show a toast message**
+
+        >>> import streamlit as st
+        >>>
+        >>> st.toast("Your edited image was saved!", icon="😍")
+
+        .. output::
+            https://doc-status-toast.streamlit.app
+            height: 200px
+
+        **Example 2: Show multiple toasts**
+
+        When multiple toasts are generated, they will stack. Hovering over a
+        toast will stop it from disappearing. When hovering ends, the toast
+        will disappear after time specified in ``duration``.
+
+        >>> import time
         >>> import streamlit as st
         >>>
-        >>> st.toast('Your edited image was saved!', icon='😍')
+        >>> if st.button("Three cheers"):
+        >>>     st.toast("Hip!")
+        >>>     time.sleep(0.5)
+        >>>     st.toast("Hip!")
+        >>>     time.sleep(0.5)
+        >>>     st.toast("Hooray!", icon="🎉")
+
+        .. output::
+            https://doc-status-toast1.streamlit.app
+            height: 300px
+
+        **Example 3: Update a toast message**
+
+        Toast messages can also be updated. Assign ``st.toast(my_message)`` to
+        a variable and use the ``.toast()`` method to update it. If a toast has
+        already disappeared or been dismissed, the update will not be seen.
+
+        >>> import time
+        >>> import streamlit as st
+        >>>
+        >>> def cook_breakfast():
+        >>>     msg = st.toast("Gathering ingredients...")
+        >>>     time.sleep(1)
+        >>>     msg.toast("Cooking...")
+        >>>     time.sleep(1)
+        >>>     msg.toast("Ready!", icon="🥞")
+        >>>
+        >>> if st.button("Cook breakfast"):
+        >>>     cook_breakfast()
+
+        .. output::
+            https://doc-status-toast2.streamlit.app
+            height: 200px
+
         """
         toast_proto = ToastProto()
         toast_proto.body = clean_text(validate_text(body))
         toast_proto.icon = validate_icon_or_emoji(icon)
+
+        if duration in ["short", "long", "infinite"] or (
+            isinstance(duration, int) and duration > 0
+        ):
+            if duration == "short":
+                toast_proto.duration = 4
+            elif duration == "long":
+                toast_proto.duration = 10
+            elif duration == "infinite":
+                toast_proto.duration = 0
+            else:
+                toast_proto.duration = duration
+        else:
+            raise StreamlitValueError(
+                "duration", ["short", "long", "infinite", "a positive integer"]
+            )
+
         return self.dg._enqueue("toast", toast_proto)
 
     @property

streamlit/elements/vega_charts.py

@@ -387,18 +387,14 @@ def _convert_altair_to_vega_lite_spec(
     alt.data_transformers.register("id", id_transform)  # type: ignore[arg-type,attr-defined,unused-ignore]
 
     # alt.themes was deprecated in Altair 5.5.0 in favor of alt.theme
-    altair_theme = (
-        alt.themes if type_util.is_altair_version_less_than("5.5.0") else alt.theme
+    alt_theme = (
+        alt.themes if type_util.is_altair_version_less_than("5.5.0") else alt.theme  # ty: ignore[unresolved-attribute]
     )
 
     # The default altair theme has some width/height defaults defined
     # which are not useful for Streamlit. Therefore, we change the theme to
     # "none" to avoid those defaults.
-    with (
-        altair_theme.enable("none")
-        if altair_theme.active == "default"
-        else nullcontext()
-    ):  # type: ignore[attr-defined,unused-ignore]
+    with alt_theme.enable("none") if alt_theme.active == "default" else nullcontext():  # ty: ignore
         with alt.data_transformers.enable("id"):  # type: ignore[attr-defined,unused-ignore]
             chart_dict = altair_chart.to_dict()
 
@@ -2083,7 +2079,6 @@ class VegaChartsMixin:
             vega_lite_proto.id = compute_and_register_element_id(
                 "arrow_vega_lite_chart",
                 user_key=key,
-                form_id=vega_lite_proto.form_id,
                 dg=self.dg,
                 vega_lite_spec=vega_lite_proto.spec,
                 # The data is either in vega_lite_proto.data.data

streamlit/elements/widgets/audio_input.py

@@ -239,7 +239,6 @@ class AudioInputMixin:
         element_id = compute_and_register_element_id(
             "audio_input",
             user_key=key,
-            form_id=current_form_id(self.dg),
             dg=self.dg,
             label=label,
             help=help,

streamlit/elements/widgets/button.py

@@ -914,8 +914,6 @@ class ButtonMixin:
         element_id = compute_and_register_element_id(
             "download_button",
             user_key=key,
-            # download_button is not allowed to be used in a form.
-            form_id=None,
             dg=self.dg,
             label=label,
             icon=icon,
@@ -1123,8 +1121,6 @@ class ButtonMixin:
         element_id = compute_and_register_element_id(
             "button",
             user_key=key,
-            # Only the
-            form_id=form_id,
             dg=self.dg,
             label=label,
             icon=icon,

streamlit/elements/widgets/button_group.py

@@ -1031,7 +1031,6 @@ class ButtonGroupMixin:
 
         check_widget_policies(self.dg, key, on_change, default_value=_default)
 
-        widget_name = "button_group"
         ctx = get_script_run_ctx()
         form_id = current_form_id(self.dg)
         formatted_options = (
@@ -1042,10 +1041,12 @@ class ButtonGroupMixin:
                 for index, _ in enumerate(indexable_options)
             ]
         )
+
         element_id = compute_and_register_element_id(
-            widget_name,
+            # The borderless style is used by st.feedback, but users expect to see
+            # "feedback" in errors
+            "feedback" if style == "borderless" else style,
             user_key=key,
-            form_id=form_id,
             dg=self.dg,
             options=formatted_options,
             default=default,
@@ -1088,7 +1089,7 @@ class ButtonGroupMixin:
         if ctx:
             save_for_app_testing(ctx, element_id, format_func)
 
-        self.dg._enqueue(widget_name, proto, layout_config=layout_config)
+        self.dg._enqueue("button_group", proto, layout_config=layout_config)
 
         return widget_state
 

streamlit/elements/widgets/camera_input.py

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

streamlit/elements/widgets/chat.py

@@ -32,7 +32,7 @@ from streamlit.elements.lib.file_uploader_utils import (
     normalize_upload_file_type,
 )
 from streamlit.elements.lib.form_utils import is_in_form
-from streamlit.elements.lib.image_utils import AtomicImage, WidthBehavior, image_to_url
+from streamlit.elements.lib.image_utils import AtomicImage, image_to_url
 from streamlit.elements.lib.layout_utils import (
     LayoutConfig,
     Width,
@@ -147,7 +147,7 @@ def _process_avatar_input(
     try:
         return AvatarType.IMAGE, image_to_url(
             avatar,
-            width=WidthBehavior.ORIGINAL,
+            layout_config=LayoutConfig(width="content"),
             clamp=False,
             channels="RGB",
             output_format="auto",
@@ -391,7 +391,7 @@ class ChatMixin:
         *,
         key: Key | None = None,
         max_chars: int | None = None,
-        accept_file: Literal[True, "multiple"],
+        accept_file: Literal[True, "multiple", "directory"],
         file_type: str | Sequence[str] | None = None,
         disabled: bool = False,
         on_submit: WidgetCallback | None = None,
@@ -407,7 +407,7 @@ class ChatMixin:
         *,
         key: Key | None = None,
         max_chars: int | None = None,
-        accept_file: bool | Literal["multiple"] = False,
+        accept_file: bool | Literal["multiple", "directory"] = False,
         file_type: str | Sequence[str] | None = None,
         disabled: bool = False,
         on_submit: WidgetCallback | None = None,
@@ -433,7 +433,7 @@ class ChatMixin:
             The maximum number of characters that can be entered. If this is
             ``None`` (default), there will be no maximum.
 
-        accept_file : bool or str
+        accept_file : bool, "multiple", or "directory"
             Whether the chat input should accept files. This can be one of the
             following values:
 
@@ -442,9 +442,9 @@ class ChatMixin:
             - ``True``: The user can add a single file to their submission.
             - ``"multiple"``: The user can add multiple files to their
               submission.
-
-            When the widget is configured to accept files, the accepted file
-            types can be configured with the ``file_type`` parameter.
+            - ``"directory"``: The user can add multiple files to their
+              submission by selecting a directory. If ``file_type`` is set,
+              only files matching those type(s) will be uploaded.
 
             By default, uploaded files are limited to 200 MB each. You can
             configure this using the ``server.maxUploadSize`` config option.
@@ -614,9 +614,9 @@ class ChatMixin:
             writes_allowed=True,
         )
 
-        if accept_file not in {True, False, "multiple"}:
+        if accept_file not in {True, False, "multiple", "directory"}:
             raise StreamlitAPIException(
-                "The `accept_file` parameter must be a boolean or 'multiple'."
+                "The `accept_file` parameter must be a boolean or 'multiple' or 'directory'."
             )
 
         ctx = get_script_run_ctx()
@@ -624,8 +624,6 @@ class ChatMixin:
         element_id = compute_and_register_element_id(
             "chat_input",
             user_key=key,
-            # chat_input is not allowed to be used in a form.
-            form_id=None,
             dg=self.dg,
             placeholder=placeholder,
             max_chars=max_chars,
@@ -677,7 +675,7 @@ class ChatMixin:
         chat_input_proto.max_upload_size_mb = config.get_option("server.maxUploadSize")
 
         serde = ChatInputSerde(
-            accept_files=bool(accept_file),
+            accept_files=accept_file in {True, "multiple", "directory"},
             allowed_types=file_type,
         )
         widget_state = register_widget(  # type: ignore[misc]

streamlit/elements/widgets/checkbox.py

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

streamlit/elements/widgets/color_picker.py

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