streamlit 1.44.1__py3-none-any.whl → 1.45.0__py3-none-any.whl

streamlit/__init__.py

@@ -117,6 +117,7 @@ from streamlit.runtime.state import (
 )
 from streamlit.user_info import (
     UserInfoProxy as _UserInfoProxy,
+    DeprecatedUserInfoProxy as _DeprecatedUserInfoProxy,
     login as _login,
     logout as _logout,
 )
@@ -277,11 +278,13 @@ fragment = _fragment
 login = _login
 logout = _logout
 
+# User
+user = _UserInfoProxy()
+
 # Experimental APIs
-experimental_audio_input = _main.experimental_audio_input
 experimental_dialog = _experimental_dialog_decorator
 experimental_fragment = _experimental_fragment
-experimental_user = _UserInfoProxy()
+experimental_user = _DeprecatedUserInfoProxy()
 
 _EXPERIMENTAL_QUERY_PARAMS_DEPRECATE_MSG = "Refer to our [docs page](https://docs.streamlit.io/develop/api-reference/caching-and-state/st.query_params) for more information."
 

streamlit/commands/execution_control.py

@@ -140,6 +140,7 @@ def rerun(  # type: ignore[misc]
     if ctx and ctx.script_requests:
         query_string = ctx.query_string
         page_script_hash = ctx.page_script_hash
+        cached_message_hashes = ctx.cached_message_hashes
 
         ctx.script_requests.request_rerun(
             RerunData(
@@ -147,6 +148,8 @@ def rerun(  # type: ignore[misc]
                 page_script_hash=page_script_hash,
                 fragment_id_queue=_new_fragment_id_queue(ctx, scope),
                 is_fragment_scoped_rerun=scope == "fragment",
+                cached_message_hashes=cached_message_hashes,
+                context_info=ctx.context_info,
             )
         )
         # Force a yield point so the runner can do the rerun
@@ -232,6 +235,7 @@ def switch_page(page: str | Path | StreamlitPage) -> NoReturn:  # type: ignore[m
         RerunData(
             query_string=ctx.query_string,
             page_script_hash=page_script_hash,
+            cached_message_hashes=ctx.cached_message_hashes,
         )
     )
     # Force a yield point so the runner can do the rerun

streamlit/commands/navigation.py

@@ -31,6 +31,7 @@ from streamlit.runtime.scriptrunner_utils.script_run_context import (
     ScriptRunContext,
     get_script_run_ctx,
 )
+from streamlit.string_util import is_emoji
 
 if TYPE_CHECKING:
     from streamlit.source_util import PageHash, PageInfo
@@ -349,7 +350,7 @@ def _navigation(
             p = msg.navigation.app_pages.add()
             p.page_script_hash = page._script_hash
             p.page_name = page.title
-            p.icon = page.icon
+            p.icon = f"emoji:{page.icon}" if is_emoji(page.icon) else page.icon
             p.is_default = page._default
             p.section_header = section_header
             p.url_pathname = page.url_path

streamlit/components/types/base_custom_component.py

@@ -60,6 +60,7 @@ class BaseCustomComponent(ABC):
         default: Any = None,
         key: str | None = None,
         on_change: WidgetCallback | None = None,
+        tab_index: int | None = None,
         **kwargs,
     ) -> Any:
         """An alias for create_instance."""
@@ -68,6 +69,7 @@ class BaseCustomComponent(ABC):
             default=default,
             key=key,
             on_change=on_change,
+            tab_index=tab_index,
             **kwargs,
         )
 
@@ -113,6 +115,7 @@ class BaseCustomComponent(ABC):
         default: Any = None,
         key: str | None = None,
         on_change: WidgetCallback | None = None,
+        tab_index: int | None = None,
         **kwargs,
     ) -> Any:
         """Create a new instance of the component.
@@ -131,6 +134,12 @@ class BaseCustomComponent(ABC):
             component's "widget ID".
         on_change: WidgetCallback or None
             An optional callback invoked when the widget's value changes. No arguments are passed to it.
+        tab_index: int or None
+            Specifies the tab order of the iframe containing the component.
+            Possible values are:
+            - ``None`` (default): Browser default behavior.
+            - ``-1``: Removes the iframe from the natural tab order, but it can still be focused programmatically.
+            - ``0`` or positive integer: Includes the iframe in the natural tab order.
         **kwargs
             Keyword args to pass to the component.
 

streamlit/components/v1/custom_component.py

@@ -52,6 +52,7 @@ class CustomComponent(BaseCustomComponent):
         default: Any = None,
         key: str | None = None,
         on_change: WidgetCallback | None = None,
+        tab_index: int | None = None,
         **kwargs,
     ) -> Any:
         """An alias for create_instance."""
@@ -60,6 +61,7 @@ class CustomComponent(BaseCustomComponent):
             default=default,
             key=key,
             on_change=on_change,
+            tab_index=tab_index,
             **kwargs,
         )
 
@@ -70,6 +72,7 @@ class CustomComponent(BaseCustomComponent):
         default: Any = None,
         key: str | None = None,
         on_change: WidgetCallback | None = None,
+        tab_index: int | None = None,
         **kwargs,
     ) -> Any:
         """Create a new instance of the component.
@@ -88,6 +91,12 @@ class CustomComponent(BaseCustomComponent):
             component's "widget ID".
         on_change: WidgetCallback or None
             An optional callback invoked when the widget's value changes. No arguments are passed to it.
+        tab_index : int, optional
+            Specifies the tab order of the iframe containing the component.
+            Possible values are:
+            - ``None`` (default): Browser default behavior.
+            - ``-1``: Removes the iframe from the natural tab order, but it can still be focused programmatically.
+            - ``0`` or positive integer: Includes the iframe in the natural tab order.
         **kwargs
             Keyword args to pass to the component.
 
@@ -100,6 +109,16 @@ class CustomComponent(BaseCustomComponent):
         if len(args) > 0:
             raise MarshallComponentException(f"Argument '{args[0]}' needs a label")
 
+        # Validate tab_index according to web specifications
+        if tab_index is not None and not (
+            isinstance(tab_index, int)
+            and not isinstance(tab_index, bool)
+            and tab_index >= -1
+        ):
+            raise StreamlitAPIException(
+                "tab_index must be None, -1, or a non-negative integer."
+            )
+
         try:
             import pyarrow  # noqa: F401, ICN001
 
@@ -148,6 +167,8 @@ And if you're using Streamlit Cloud, add "pyarrow" to your requirements.txt."""
             element.component_instance.form_id = current_form_id(dg)
             if self.url is not None:
                 element.component_instance.url = self.url
+            if tab_index is not None:
+                element.component_instance.tab_index = tab_index
 
             # Normally, a widget's element_hash (which determines
             # its identity across multiple runs of an app) is computed

streamlit/config.py

@@ -17,12 +17,13 @@
 from __future__ import annotations
 
 import copy
+import logging
 import os
 import secrets
 import threading
 from collections import OrderedDict
 from enum import Enum
-from typing import Any, Callable, Literal
+from typing import Any, Callable, Final, Literal
 
 from blinker import Signal
 
@@ -55,14 +56,16 @@ _config_options: dict[str, ConfigOption] | None = None
 
 
 # Indicates that a config option was defined by the user.
-_USER_DEFINED = "<user defined>"
+_USER_DEFINED: Final = "<user defined>"
 
 # Indicates that a config option was defined either in an environment variable
 # or via command-line flag.
-_DEFINED_BY_FLAG = "command-line argument or environment variable"
+_DEFINED_BY_FLAG: Final = "command-line argument or environment variable"
 
 # Indicates that a config option was defined in an environment variable
-_DEFINED_BY_ENV_VAR = "environment variable"
+_DEFINED_BY_ENV_VAR: Final = "environment variable"
+
+_LOGGER: Final = logging.getLogger(__name__)
 
 
 class ShowErrorDetailsConfigOptions(str, Enum):
@@ -82,8 +85,9 @@ class ShowErrorDetailsConfigOptions(str, Enum):
         return val in ["false", "False", False]
 
         # Config options can be set from several places including the command-line and
-        # the user's script. Legacy config options (true/false) will have type string when set via
-        # command-line and bool when set via user script (e.g. st.set_option("client.showErrorDetails", False)).
+        # the user's script. Legacy config options (true/false) will have type string
+        # when set via command-line and bool when set via user script
+        # (e.g. st.set_option("client.showErrorDetails", False)).
 
 
 class CustomThemeCategories(str, Enum):
@@ -162,7 +166,8 @@ def set_user_option(key: str, value: Any) -> None:
         return
 
     raise StreamlitAPIException(
-        f"{key} cannot be set on the fly. Set as command line option, e.g. streamlit run script.py --{key}, or in config.toml instead."
+        f"{key} cannot be set on the fly. Set as command line option, e.g. "
+        "streamlit run script.py --{key}, or in config.toml instead."
     )
 
 
@@ -308,8 +313,11 @@ def _create_theme_options(
     type_: type = str,
 ) -> None:
     """
-    Create ConfigOption(s) for a theme-related config option and store it globally in this module.
-    The same config option can be supported for multiple categories, e.g. "theme" and "theme.sidebar".
+    Create ConfigOption(s) for a theme-related config option and store it globally in
+    this module.
+
+    The same config option can be supported for multiple categories, e.g. "theme"
+    and "theme.sidebar".
     """
     for cat in categories:
         section = cat if cat == "theme" else f"theme.{cat.value}"
@@ -444,32 +452,6 @@ _create_option(
     type_=int,
 )
 
-_create_option(
-    "global.storeCachedForwardMessagesInMemory",
-    description="""
-        If True, store cached ForwardMsgs in backend memory. This is an
-        internal flag to validate a potential removal of the in-memory
-        forward message cache.
-    """,
-    visibility="hidden",
-    default_val=True,
-    type_=bool,
-)
-
-_create_option(
-    "global.includeFragmentRunsInForwardMessageCacheCount",
-    description="""
-        If True, the server will include fragment runs in the count for the
-        forward message cache. The implication is that apps with fragments may
-        see messages being removed from the cache faster. This aligns the server
-        count with the frontend count. This is a temporary fix while we assess the
-        design of the cache.
-    """,
-    visibility="hidden",
-    default_val=False,
-    type_=bool,
-)
-
 
 # Config Section: Logger #
 _create_section("logger", "Settings to customize Streamlit log messages.")
@@ -729,7 +711,11 @@ def _server_headless() -> bool:
     Default: false unless (1) we are on a Linux box where DISPLAY is unset, or
     (2) we are running in the Streamlit Atom plugin.
     """
-    if env_util.IS_LINUX_OR_BSD and not os.getenv("DISPLAY"):
+    if (
+        env_util.IS_LINUX_OR_BSD
+        and not os.getenv("DISPLAY")
+        and not os.getenv("WAYLAND_DISPLAY")
+    ):
         # We're running in Linux and DISPLAY is unset
         return True
 
@@ -836,7 +822,9 @@ _create_option(
     description="""
         Max size, in megabytes, for files uploaded with the file_uploader.
     """,
-    default_val=200,  # If this default is changed, please also update the docstring for `DeltaGenerator.file_uploader`.
+    # If this default is changed, please also update the docstring
+    # for `DeltaGenerator.file_uploader`.
+    default_val=200,
     type_=int,
 )
 
@@ -853,8 +841,9 @@ _create_option(
 _create_option(
     "server.enableArrowTruncation",
     description="""
-        Enable automatically truncating all data structures that get serialized into Arrow (e.g. DataFrames)
-        to ensure that the size is under `server.maxMessageSize`.
+        Enable automatically truncating all data structures that get serialized
+        into Arrow (e.g. DataFrames) to ensure that the size is under
+        `server.maxMessageSize`.
     """,
     visibility="hidden",
     default_val=False,
@@ -1233,8 +1222,8 @@ _create_option(
         will take precedence over earlier ones.
     """,
     default_val=[
-        # NOTE: The order here is important! Project-level secrets should overwrite global
-        # secrets.
+        # NOTE: The order here is important! Project-level secrets should overwrite
+        # global secrets.
         file_util.get_streamlit_file_path("secrets.toml"),
         file_util.get_project_streamlit_file_path("secrets.toml"),
     ],
@@ -1370,9 +1359,18 @@ def _update_config_with_toml(raw_toml: str, where_defined: str) -> None:
         Tells the config system where this was set.
 
     """
-    import toml
+    try:
+        import toml
 
-    parsed_config_file = toml.loads(raw_toml)
+        parsed_config_file = toml.loads(raw_toml)
+    except Exception:
+        # Catching any parsing exception to prevent this from breaking our
+        # config change watcher logic.
+        _LOGGER.exception(
+            "Error parsing config toml. This is most likely due to a syntax error "
+            "in the config.toml file. Please fix it and try again.",
+        )
+        return
 
     def process_section(section_path: str, section_data: dict[str, Any]) -> None:
         """Recursively process nested sections of the config file.
@@ -1415,8 +1413,7 @@ def _update_config_with_toml(raw_toml: str, where_defined: str) -> None:
                 process_section(option_name, value)
             else:
                 # It's a regular config option, set it
-                value = _maybe_read_env_variable(value)
-                _set_option(option_name, value, where_defined)
+                _set_option(option_name, _maybe_read_env_variable(value), where_defined)
 
     for section, options in parsed_config_file.items():
         process_section(section, options)
@@ -1508,7 +1505,7 @@ def get_config_options(
     dict[str, ConfigOption]
         An ordered dict that maps config option names to their values.
     """
-    global _config_options
+    global _config_options  # noqa: PLW0603
 
     if not options_from_flags:
         options_from_flags = {}
@@ -1586,7 +1583,8 @@ def _check_conflicts() -> None:
         if not get_option("server.enableCORS") or get_option("global.developmentMode"):
             LOGGER.warning(
                 """
-Warning: the config option 'server.enableCORS=false' is not compatible with 'server.enableXsrfProtection=true'.
+Warning: the config option 'server.enableCORS=false' is not compatible with
+'server.enableXsrfProtection=true'.
 As a result, 'server.enableCORS' is being overridden to 'true'.
 
 More information:

streamlit/config_util.py

@@ -87,7 +87,7 @@ def show_config(
         append_section("[%s]" % section)
         out.append("")
 
-        for key, option in section_options.items():
+        for _, option in section_options.items():
             key = option.key.split(".")[-1]
             description_paragraphs = _clean_paragraphs(option.description or "")
 

streamlit/delta_generator.py

@@ -121,7 +121,7 @@ def _maybe_print_use_warning() -> None:
     """Print a warning if Streamlit is imported but not being run with `streamlit run`.
     The warning is printed only once, and is printed using the root logger.
     """
-    global _use_warning_has_been_displayed
+    global _use_warning_has_been_displayed  # noqa: PLW0603
 
     if not _use_warning_has_been_displayed:
         _use_warning_has_been_displayed = True
@@ -487,6 +487,10 @@ class DeltaGenerator(
                 cursor=new_cursor,
                 parent=dg,
             )
+
+            # Elements inherit their parent form ids.
+            # NOTE: Form ids aren't set in dg constructor.
+            output_dg._form_data = FormData(current_form_id(dg))
         else:
             # If the message was not enqueued, just return self since it's a
             # no-op from the point of view of the app.

streamlit/deprecation_util.py

@@ -139,7 +139,7 @@ def deprecate_obj_name(
 
     include_st_prefix
         If False, does not prefix each of the object names in the deprecation
-        essage with `st.*`. Defaults to True.
+        message with `st.*`. Defaults to True.
     """
 
     return _create_deprecated_obj_wrapper(
@@ -188,13 +188,13 @@ def _create_deprecated_obj_wrapper(obj: TObj, show_warning: Callable[[], Any]) -
             return getattr(obj, attr)
 
         @staticmethod
-        def _get_magic_functions(cls) -> list[str]:
+        def _get_magic_functions(self_cls) -> list[str]:
             # ignore the handful of magic functions we cannot override without
             # breaking the Wrapper.
             ignore = ("__class__", "__dict__", "__getattribute__", "__getattr__")
             return [
                 name
-                for name in dir(cls)
+                for name in dir(self_cls)
                 if name not in ignore and name.startswith("__")
             ]
 

streamlit/elements/alert.py

@@ -16,12 +16,15 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, cast
 
+from streamlit.elements.lib.layout_utils import validate_width
 from streamlit.proto.Alert_pb2 import Alert as AlertProto
+from streamlit.proto.WidthConfig_pb2 import WidthConfig
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.string_util import clean_text, validate_icon_or_emoji
 
 if TYPE_CHECKING:
     from streamlit.delta_generator import DeltaGenerator
+    from streamlit.elements.lib.layout_utils import WidthWithoutContent
     from streamlit.type_util import SupportsStr
 
 
@@ -32,6 +35,7 @@ class AlertMixin:
         body: SupportsStr,
         *,  # keyword-only args:
         icon: str | None = None,
+        width: WidthWithoutContent = "stretch",
     ) -> DeltaGenerator:
         """Display error message.
 
@@ -62,6 +66,13 @@ class AlertMixin:
               Thumb Up icon. Find additional icons in the `Material Symbols \
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
+        width : int or "stretch"
+            The desired width of the alert expressed in pixels. If this is
+            ``"stretch"`` (default), Streamlit sets the width of the alert to
+            match the width of the parent container. Otherwise, this must be an
+            integer. If the specified width is greater than the width of the
+            parent container, Streamlit sets the width of the alert to match
+            the width of the parent container.
 
         Example
         -------
@@ -75,6 +86,18 @@ class AlertMixin:
         alert_proto.icon = validate_icon_or_emoji(icon)
         alert_proto.body = clean_text(body)
         alert_proto.format = AlertProto.ERROR
+
+        validate_width(width)
+
+        width_config = WidthConfig()
+
+        if isinstance(width, int):
+            width_config.pixel_width = width
+        else:
+            width_config.use_stretch = True
+
+        alert_proto.width_config.CopyFrom(width_config)
+
         return self.dg._enqueue("alert", alert_proto)
 
     @gather_metrics("warning")
@@ -83,6 +106,7 @@ class AlertMixin:
         body: SupportsStr,
         *,  # keyword-only args:
         icon: str | None = None,
+        width: WidthWithoutContent = "stretch",
     ) -> DeltaGenerator:
         """Display warning message.
 
@@ -113,6 +137,13 @@ class AlertMixin:
               Thumb Up icon. Find additional icons in the `Material Symbols \
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
+        width : int or "stretch"
+            The desired width of the alert expressed in pixels. If this is
+            ``"stretch"`` (default), Streamlit sets the width of the alert to
+            match the width of the parent container. Otherwise, this must be an
+            integer. If the specified width is greater than the width of the
+            parent container, Streamlit sets the width of the alert to match
+            the width of the parent container.
 
         Example
         -------
@@ -125,6 +156,18 @@ class AlertMixin:
         alert_proto.body = clean_text(body)
         alert_proto.icon = validate_icon_or_emoji(icon)
         alert_proto.format = AlertProto.WARNING
+
+        validate_width(width)
+
+        width_config = WidthConfig()
+
+        if isinstance(width, int):
+            width_config.pixel_width = width
+        else:
+            width_config.use_stretch = True
+
+        alert_proto.width_config.CopyFrom(width_config)
+
         return self.dg._enqueue("alert", alert_proto)
 
     @gather_metrics("info")
@@ -133,6 +176,7 @@ class AlertMixin:
         body: SupportsStr,
         *,  # keyword-only args:
         icon: str | None = None,
+        width: WidthWithoutContent = "stretch",
     ) -> DeltaGenerator:
         """Display an informational message.
 
@@ -163,6 +207,13 @@ class AlertMixin:
               Thumb Up icon. Find additional icons in the `Material Symbols \
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
+        width : int or "stretch"
+            The desired width of the alert expressed in pixels. If this is
+            ``"stretch"`` (default), Streamlit sets the width of the alert to
+            match the width of the parent container. Otherwise, this must be an
+            integer. If the specified width is greater than the width of the
+            parent container, Streamlit sets the width of the alert to match
+            the width of the parent container.
 
         Example
         -------
@@ -176,6 +227,18 @@ class AlertMixin:
         alert_proto.body = clean_text(body)
         alert_proto.icon = validate_icon_or_emoji(icon)
         alert_proto.format = AlertProto.INFO
+
+        validate_width(width)
+
+        width_config = WidthConfig()
+
+        if isinstance(width, int):
+            width_config.pixel_width = width
+        else:
+            width_config.use_stretch = True
+
+        alert_proto.width_config.CopyFrom(width_config)
+
         return self.dg._enqueue("alert", alert_proto)
 
     @gather_metrics("success")
@@ -184,6 +247,7 @@ class AlertMixin:
         body: SupportsStr,
         *,  # keyword-only args:
         icon: str | None = None,
+        width: WidthWithoutContent = "stretch",
     ) -> DeltaGenerator:
         """Display a success message.
 
@@ -214,6 +278,13 @@ class AlertMixin:
               Thumb Up icon. Find additional icons in the `Material Symbols \
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
+        width : int or "stretch"
+            The desired width of the alert expressed in pixels. If this is
+            ``"stretch"`` (default), Streamlit sets the width of the alert to
+            match the width of the parent container. Otherwise, this must be an
+            integer. If the specified width is greater than the width of the
+            parent container, Streamlit sets the width of the alert to match
+            the width of the parent container.
 
         Example
         -------
@@ -226,6 +297,18 @@ class AlertMixin:
         alert_proto.body = clean_text(body)
         alert_proto.icon = validate_icon_or_emoji(icon)
         alert_proto.format = AlertProto.SUCCESS
+
+        validate_width(width)
+
+        width_config = WidthConfig()
+
+        if isinstance(width, int):
+            width_config.pixel_width = width
+        else:
+            width_config.use_stretch = True
+
+        alert_proto.width_config.CopyFrom(width_config)
+
         return self.dg._enqueue("alert", alert_proto)
 
     @property