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

streamlit/dataframe_util.py

@@ -30,14 +30,14 @@ from typing import (
     Any,
     Final,
     Protocol,
+    TypeAlias,
+    TypeGuard,
     TypeVar,
     Union,
     cast,
     runtime_checkable,
 )
 
-from typing_extensions import TypeAlias, TypeGuard
-
 from streamlit import config, errors, logger, string_util
 from streamlit.type_util import (
     CustomDict,
@@ -165,12 +165,12 @@ class DataframeInterchangeCompatible(Protocol):
     def __dataframe__(self, allow_copy: bool) -> Any: ...
 
 
-OptionSequence: TypeAlias = Union[
-    Iterable[V_co],
-    DataFrameGenericAlias[V_co],
-    PandasCompatible,
-    DataframeInterchangeCompatible,
-]
+OptionSequence: TypeAlias = (
+    Iterable[V_co]
+    | DataFrameGenericAlias[V_co]
+    | PandasCompatible
+    | DataframeInterchangeCompatible
+)
 
 # Various data types supported by our dataframe processing
 # used for commands like `st.dataframe`, `st.table`, `st.map`,
@@ -528,6 +528,13 @@ def _dict_to_pandas_df(data: dict[Any, Any]) -> DataFrame:
     return _fix_column_naming(pd.DataFrame.from_dict(data, orient="index"))
 
 
+def has_range_index(df: DataFrame) -> bool:
+    """True if the dataframe has a range index."""
+    from pandas import RangeIndex
+
+    return isinstance(df.index, RangeIndex)
+
+
 def convert_anything_to_pandas_df(
     data: Any,
     max_unevaluated_rows: int = _MAX_UNEVALUATED_DF_ROWS,

streamlit/delta_generator.py

@@ -17,21 +17,19 @@
 from __future__ import annotations
 
 import sys
-from collections.abc import Iterable
+from collections.abc import Callable, Iterable
 from copy import deepcopy
 from typing import (
     TYPE_CHECKING,
     Any,
-    Callable,
     Final,
     Literal,
     NoReturn,
+    TypeAlias,
     TypeVar,
     cast,
 )
 
-from typing_extensions import TypeAlias
-
 from streamlit import (
     cli_util,
     config,
@@ -41,6 +39,7 @@ from streamlit import (
     runtime,
     util,
 )
+from streamlit.components.v2.bidi_component import BidiComponentMixin
 from streamlit.delta_generator_singletons import (
     context_dg_stack,
     get_last_dg_added_to_context_stack,
@@ -76,6 +75,7 @@ from streamlit.elements.plotly_chart import PlotlyMixin
 from streamlit.elements.progress import ProgressMixin
 from streamlit.elements.pyplot import PyplotMixin
 from streamlit.elements.snow import SnowMixin
+from streamlit.elements.space import SpaceMixin
 from streamlit.elements.text import TextMixin
 from streamlit.elements.toast import ToastMixin
 from streamlit.elements.vega_charts import VegaChartsMixin
@@ -207,6 +207,7 @@ class DeltaGenerator(
     SelectSliderMixin,
     SliderMixin,
     SnowMixin,
+    SpaceMixin,
     JsonMixin,
     TextMixin,
     TextWidgetsMixin,
@@ -216,6 +217,7 @@ class DeltaGenerator(
     ArrowMixin,
     VegaChartsMixin,
     DataEditorMixin,
+    BidiComponentMixin,
 ):
     """Creator of Delta protobuf messages.
 

streamlit/delta_generator_singletons.py

@@ -20,11 +20,13 @@ cycle between streamlit.delta_generator and some elements.
 from __future__ import annotations
 
 from contextvars import ContextVar, Token
-from typing import TYPE_CHECKING, Callable, Generic, TypeVar
+from typing import TYPE_CHECKING, Generic, TypeVar
 
 from streamlit.proto.RootContainer_pb2 import RootContainer as _RootContainer
 
 if TYPE_CHECKING:
+    from collections.abc import Callable
+
     from streamlit.delta_generator import DeltaGenerator
     from streamlit.elements.lib.dialog import Dialog
     from streamlit.elements.lib.mutable_status_container import StatusContainer

streamlit/deprecation_util.py

@@ -15,7 +15,8 @@
 from __future__ import annotations
 
 import functools
-from typing import Any, Callable, Final, TypeVar, cast
+from collections.abc import Callable
+from typing import Any, Final, TypeVar, cast
 
 import streamlit
 from streamlit import config
@@ -28,8 +29,17 @@ TObj = TypeVar("TObj", bound=object)
 
 
 def _error_details_in_browser_enabled() -> bool:
-    """True if we should print deprecation warnings to the browser."""
-    return bool(config.get_option("client.showErrorDetails"))
+    """True if we should print deprecation warnings to the browser.
+
+    Deprecation warnings are only shown when showErrorDetails is set to "full"
+    or the legacy True value. All other values ("stacktrace", "type", "none",
+    False) hide deprecation warnings in the browser.
+    """
+    show_error_details = config.get_option("client.showErrorDetails")
+    return (
+        show_error_details == config.ShowErrorDetailsConfigOptions.FULL
+        or config.ShowErrorDetailsConfigOptions.is_true_variation(show_error_details)
+    )
 
 
 def show_deprecation_warning(message: str, show_in_browser: bool = True) -> None:
@@ -41,9 +51,10 @@ def show_deprecation_warning(message: str, show_in_browser: bool = True) -> None
         The deprecation warning message.
     show_in_browser : bool, default=True
         Whether to show the deprecation warning in the browser. When this is True,
-        we will show the deprecation warning in the browser unless the user has
-        disabled error details in the browser by setting the `client.showErrorDetails`
-        config option to "none".
+        we will show the deprecation warning in the browser only if the user has
+        set `client.showErrorDetails` to "full" or the legacy True value. All
+        other values ("stacktrace", "type", "none", False) will hide deprecation
+        warnings in the browser (but still log them to the console).
     """
     if _error_details_in_browser_enabled() and show_in_browser:
         streamlit.warning(message)

streamlit/elements/arrow.py

@@ -16,9 +16,16 @@ from __future__ import annotations
 
 import json
 from dataclasses import dataclass
-from typing import TYPE_CHECKING, Any, Final, Literal, TypedDict, cast, overload
-
-from typing_extensions import TypeAlias
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Final,
+    Literal,
+    TypeAlias,
+    TypedDict,
+    cast,
+    overload,
+)
 
 from streamlit import dataframe_util
 from streamlit.deprecation_util import (
@@ -35,6 +42,7 @@ from streamlit.elements.lib.column_config_utils import (
 )
 from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.layout_utils import (
+    HeightWithoutContent,
     LayoutConfig,
     Width,
     validate_height,
@@ -279,7 +287,7 @@ class ArrowMixin:
         self,
         data: Data = None,
         width: Width = "stretch",
-        height: int | Literal["auto"] = "auto",
+        height: HeightWithoutContent | Literal["auto"] = "auto",
         *,
         use_container_width: bool | None = None,
         hide_index: bool | None = None,
@@ -296,7 +304,7 @@ class ArrowMixin:
         self,
         data: Data = None,
         width: Width = "stretch",
-        height: int | Literal["auto"] = "auto",
+        height: HeightWithoutContent | Literal["auto"] = "auto",
         *,
         use_container_width: bool | None = None,
         hide_index: bool | None = None,
@@ -313,7 +321,7 @@ class ArrowMixin:
         self,
         data: Data = None,
         width: Width = "stretch",
-        height: int | Literal["auto"] = "auto",
+        height: HeightWithoutContent | Literal["auto"] = "auto",
         *,
         use_container_width: bool | None = None,
         hide_index: bool | None = None,
@@ -381,11 +389,18 @@ class ArrowMixin:
               the parent container, the width of the element matches the width
               of the parent container.
 
-        height : int or "auto"
+        height : "auto", "stretch", or int
             The height of the dataframe element. This can be one of the following:
 
             - ``"auto"`` (default): Streamlit sets the height to show at most
               ten rows.
+            - ``"stretch"``: The height of the element expands to fill the
+              available vertical space in its parent container. When multiple
+              elements with stretch height are in the same container, they
+              share the available vertical space evenly. The dataframe will
+              maintain a minimum height to display up to three rows, but
+              otherwise won't exceed the available height in its parent
+              container.
             - An integer specifying the height in pixels: The element has a
               fixed height.
 
@@ -407,7 +422,7 @@ class ArrowMixin:
         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
-            determined based on the data.
+            determined based on the data and other configurations.
 
         column_order : Iterable[str] or None
             The ordered list of columns to display. If this is ``None``
@@ -662,7 +677,6 @@ class ArrowMixin:
         validate_height(
             height,
             allow_content=False,
-            allow_stretch=False,
             additional_allowed=["auto"],
         )
 
@@ -679,6 +693,7 @@ class ArrowMixin:
 
         proto.editing_mode = ArrowProto.EditingMode.READ_ONLY
 
+        has_range_index: bool = False
         if isinstance(data, pa.Table):
             # For pyarrow tables, we can just serialize the table directly
             proto.data = dataframe_util.convert_arrow_table_to_arrow_bytes(data)
@@ -701,6 +716,7 @@ class ArrowMixin:
             data_df = dataframe_util.convert_anything_to_pandas_df(
                 data, ensure_copy=False
             )
+            has_range_index = dataframe_util.has_range_index(data_df)
             apply_data_specific_configs(column_config_mapping, data_format)
             # Serialize the data to bytes:
             proto.data = dataframe_util.convert_pandas_df_to_arrow_bytes(data_df)
@@ -709,6 +725,18 @@ class ArrowMixin:
             update_column_config(
                 column_config_mapping, INDEX_IDENTIFIER, {"hidden": hide_index}
             )
+
+        elif (
+            # Hide index column if row selections are activated and the dataframe has a range index.
+            # The range index usually does not add a lot of value.
+            is_selection_activated
+            and selection_mode in ["multi-row", "single-row"]
+            and has_range_index
+        ):
+            update_column_config(
+                column_config_mapping, INDEX_IDENTIFIER, {"hidden": True}
+            )
+
         marshall_column_config(proto, column_config_mapping)
 
         # Create layout configuration

streamlit/elements/deck_gl_json_chart.py

@@ -21,15 +21,25 @@ from typing import (
     Any,
     Final,
     Literal,
+    TypeAlias,
     TypedDict,
     cast,
     overload,
 )
 
-from typing_extensions import TypeAlias
-
 from streamlit import config
+from streamlit.deprecation_util import (
+    make_deprecated_name_warning,
+    show_deprecation_warning,
+)
 from streamlit.elements.lib.form_utils import current_form_id
+from streamlit.elements.lib.layout_utils import (
+    HeightWithoutContent,
+    LayoutConfig,
+    WidthWithoutContent,
+    validate_height,
+    validate_width,
+)
 from streamlit.elements.lib.policies import check_widget_policies
 from streamlit.elements.lib.utils import Key, compute_and_register_element_id, to_key
 from streamlit.errors import StreamlitAPIException
@@ -263,9 +273,9 @@ class PydeckMixin:
         self,
         pydeck_obj: Deck | None = None,
         *,
-        use_container_width: bool = True,
-        width: int | None = None,
-        height: int | None = None,
+        width: WidthWithoutContent = "stretch",
+        use_container_width: bool | None = None,
+        height: HeightWithoutContent = 500,
         selection_mode: Literal[
             "single-object"
         ],  # Selection mode will only be activated by on_select param; default value here to make it work with mypy
@@ -279,9 +289,9 @@ class PydeckMixin:
         self,
         pydeck_obj: Deck | None = None,
         *,
-        use_container_width: bool = True,
-        width: int | None = None,
-        height: int | None = None,
+        width: WidthWithoutContent = "stretch",
+        use_container_width: bool | None = None,
+        height: HeightWithoutContent = 500,
         selection_mode: SelectionMode = "single-object",
         on_select: Literal["rerun"] | WidgetCallback = "rerun",
         key: Key | None = None,
@@ -292,9 +302,9 @@ class PydeckMixin:
         self,
         pydeck_obj: Deck | None = None,
         *,
-        use_container_width: bool = True,
-        width: int | None = None,
-        height: int | None = None,
+        width: WidthWithoutContent = "stretch",
+        use_container_width: bool | None = None,
+        height: HeightWithoutContent = 500,
         selection_mode: SelectionMode = "single-object",
         on_select: Literal["rerun", "ignore"] | WidgetCallback = "ignore",
         key: Key | None = None,
@@ -342,26 +352,43 @@ class PydeckMixin:
         ----------
         pydeck_obj : pydeck.Deck or None
             Object specifying the PyDeck chart to draw.
-        use_container_width : bool
-            Whether to override the figure's native width with the width of
-            the parent container. If ``use_container_width`` is ``True`` (default),
-            Streamlit sets the width of the figure to match the width of the parent
-            container. If ``use_container_width`` is ``False``, Streamlit sets the
-            width of the chart to fit its contents according to the plotting library,
-            up to the width of the parent container.
-        width : int or None
-            Desired width of the chart expressed in pixels. If ``width`` is
-            ``None`` (default), Streamlit sets the width of the chart to fit
-            its contents according to the plotting library, up to the width of
-            the parent container. If ``width`` is greater than the width of the
-            parent container, Streamlit sets the chart width to match the width
-            of the parent container.
-
-            To use ``width``, you must set ``use_container_width=False``.
-        height : int or None
-            Desired height of the chart expressed in pixels. If ``height`` is
-            ``None`` (default), Streamlit sets the height of the chart to fit
-            its contents according to the plotting library.
+        width : "stretch" or int
+            The width of the chart element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
+
+        use_container_width : bool or None
+            Whether to override the chart's native width with the width of
+            the parent container. This can be one of the following:
+
+            - ``None`` (default): Streamlit will use the chart's default behavior.
+            - ``True``: Streamlit sets the width of the chart to match the
+              width of the parent container.
+            - ``False``: Streamlit sets the width of the chart to fit its
+              contents according to the plotting library, up to 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"``.
+
+        height : "stretch" or int
+            The height of the chart element. This can be one of the following:
+
+            - An integer specifying the height in pixels: The element has a
+              fixed height. If the content is larger than the specified
+              height, scrolling is enabled. This is ``500`` by default.
+            - ``"stretch"``: The height of the element matches the height of
+              its content or the height of the parent container, whichever is
+              larger. If the element is not in a parent container, the height
+              of the element matches the height of its content.
+
         on_select : "ignore" or "rerun" or callable
             How the figure should respond to user selection events. This controls
             whether or not the chart behaves like an input widget.
@@ -460,6 +487,25 @@ class PydeckMixin:
            you can set ``map_style=None`` in the ``pydeck.Deck`` object.
 
         """
+        if use_container_width is not None:
+            show_deprecation_warning(
+                make_deprecated_name_warning(
+                    "use_container_width",
+                    "width",
+                    "2025-12-31",
+                    "For `use_container_width=True`, use `width='stretch'`. "
+                    "For `use_container_width=False`, specify an integer width.",
+                    include_st_prefix=False,
+                ),
+                show_in_browser=False,
+            )
+            if use_container_width:
+                width = "stretch"
+            # Otherwise keep the provided width.
+
+        validate_width(width, allow_content=False)
+        validate_height(height, allow_content=False)
+
         pydeck_proto = PydeckProto()
 
         ctx = get_script_run_ctx()
@@ -467,12 +513,6 @@ class PydeckMixin:
         spec = json.dumps(EMPTY_MAP) if pydeck_obj is None else pydeck_obj.to_json()
 
         pydeck_proto.json = spec
-        pydeck_proto.use_container_width = use_container_width
-
-        if width:
-            pydeck_proto.width = width
-        if height:
-            pydeck_proto.height = height
 
         tooltip = _get_pydeck_tooltip(pydeck_obj)
         if tooltip:
@@ -535,11 +575,17 @@ class PydeckMixin:
                 value_type="string_value",
             )
 
-            self.dg._enqueue("deck_gl_json_chart", pydeck_proto)
+            layout_config = LayoutConfig(width=width, height=height)
+            self.dg._enqueue(
+                "deck_gl_json_chart", pydeck_proto, layout_config=layout_config
+            )
 
             return widget_state.value
 
-        return self.dg._enqueue("deck_gl_json_chart", pydeck_proto)
+        layout_config = LayoutConfig(width=width, height=height)
+        return self.dg._enqueue(
+            "deck_gl_json_chart", pydeck_proto, layout_config=layout_config
+        )
 
     @property
     def dg(self) -> DeltaGenerator:
@@ -547,6 +593,18 @@ class PydeckMixin:
         return cast("DeltaGenerator", self)
 
 
+def _get_pydeck_width(pydeck_obj: Deck | None) -> int | None:
+    """Extract the width from a pydeck Deck object, if specified."""
+    if pydeck_obj is None:
+        return None
+
+    width = getattr(pydeck_obj, "width", None)
+    if width is not None and isinstance(width, (int, float)):
+        return int(width)
+
+    return None
+
+
 def _get_pydeck_tooltip(pydeck_obj: Deck | None) -> dict[str, str] | None:
     if pydeck_obj is None:
         return None

streamlit/elements/dialog_decorator.py

@@ -14,8 +14,9 @@
 
 from __future__ import annotations
 
+from collections.abc import Callable
 from functools import wraps
-from typing import TYPE_CHECKING, Any, Callable, Literal, TypeVar, cast, overload
+from typing import TYPE_CHECKING, Any, Literal, TypeVar, cast, overload
 
 from streamlit.delta_generator_singletons import (
     get_dg_singleton_instance,

streamlit/elements/exception.py

@@ -16,7 +16,7 @@ from __future__ import annotations
 
 import os
 import traceback
-from typing import TYPE_CHECKING, Callable, Final, TypeVar, cast
+from typing import TYPE_CHECKING, Final, TypeVar, cast
 
 from streamlit import config
 from streamlit.elements.lib.layout_utils import validate_width
@@ -31,6 +31,8 @@ from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner_utils.script_run_context import get_script_run_ctx
 
 if TYPE_CHECKING:
+    from collections.abc import Callable
+
     from streamlit.delta_generator import DeltaGenerator
     from streamlit.elements.lib.layout_utils import WidthWithoutContent
 

streamlit/elements/graphviz_chart.py

@@ -16,9 +16,7 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Union, cast
-
-from typing_extensions import TypeAlias
+from typing import TYPE_CHECKING, TypeAlias, Union, cast
 
 from streamlit import type_util
 from streamlit.deprecation_util import (

streamlit/elements/heading.py

@@ -15,9 +15,7 @@
 from __future__ import annotations
 
 from enum import Enum
-from typing import TYPE_CHECKING, Literal, Union, cast
-
-from typing_extensions import TypeAlias
+from typing import TYPE_CHECKING, Literal, TypeAlias, cast
 
 from streamlit.elements.lib.layout_utils import LayoutConfig, validate_width
 from streamlit.errors import StreamlitAPIException
@@ -37,8 +35,8 @@ class HeadingProtoTag(Enum):
     SUBHEADER_TAG = "h3"
 
 
-Anchor: TypeAlias = Union[str, Literal[False], None]
-Divider: TypeAlias = Union[bool, str, None]
+Anchor: TypeAlias = str | Literal[False] | None
+Divider: TypeAlias = bool | str | None
 
 
 class HeadingMixin:

streamlit/elements/image.py

@@ -21,9 +21,7 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Literal, Union, cast
-
-from typing_extensions import TypeAlias
+from typing import TYPE_CHECKING, Literal, TypeAlias, cast
 
 from streamlit.deprecation_util import (
     make_deprecated_name_warning,
@@ -43,7 +41,7 @@ from streamlit.runtime.metrics_util import gather_metrics
 if TYPE_CHECKING:
     from streamlit.delta_generator import DeltaGenerator
 
-UseColumnWith: TypeAlias = Union[Literal["auto", "always", "never"], bool, None]
+UseColumnWith: TypeAlias = Literal["auto", "always", "never"] | bool | None
 
 
 class ImageMixin:

streamlit/elements/layouts.py

@@ -15,9 +15,7 @@
 from __future__ import annotations
 
 from collections.abc import Sequence
-from typing import TYPE_CHECKING, Literal, Union, cast
-
-from typing_extensions import TypeAlias
+from typing import TYPE_CHECKING, Literal, TypeAlias, cast
 
 from streamlit.delta_generator_singletons import get_dg_singleton_instance
 from streamlit.elements.lib.layout_utils import (
@@ -54,7 +52,7 @@ if TYPE_CHECKING:
     from streamlit.elements.lib.mutable_status_container import StatusContainer
     from streamlit.runtime.state import WidgetCallback
 
-SpecType: TypeAlias = Union[int, Sequence[Union[int, float]]]
+SpecType: TypeAlias = int | Sequence[int | float]
 
 
 class LayoutsMixin:
@@ -385,13 +383,15 @@ class LayoutsMixin:
             ``False`` (default), no border is shown. If this is ``True``, a
             border is shown around each column.
 
-        width : int or "stretch"
-            The desired width of the columns expressed in pixels. If this is
-            ``"stretch"`` (default), Streamlit sets the width of the columns 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 columns to match
-            the width of the parent container.
+        width : "stretch" or int
+            The width of the column group. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the column group matches the
+              width of the parent container.
+            - An integer specifying the width in pixels: The column group has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the column group matches the
+              width of the parent container.
 
         Returns
         -------
@@ -862,6 +862,7 @@ class LayoutsMixin:
         self,
         label: str,
         *,
+        type: Literal["primary", "secondary", "tertiary"] = "secondary",
         help: str | None = None,
         icon: str | None = None,
         disabled: bool = False,
@@ -912,6 +913,17 @@ class LayoutsMixin:
             including the Markdown directives described in the ``body``
             parameter of ``st.markdown``.
 
+        type : "primary", "secondary", or "tertiary"
+            An optional string that specifies the button type. This can be one
+            of the following:
+
+            - ``"primary"``: The button's background is the app's primary color
+              for additional emphasis.
+            - ``"secondary"`` (default): The button's background coordinates
+              with the app's background color for normal emphasis.
+            - ``"tertiary"``: The button is plain text without a border or
+              background for subtlety.
+
         icon : str
             An optional emoji or icon to display next to the button label. If ``icon``
             is ``None`` (default), no icon is displayed. If ``icon`` is a
@@ -1009,9 +1021,17 @@ class LayoutsMixin:
         if use_container_width is not None:
             width = "stretch" if use_container_width else "content"
 
+        # Checks whether the entered button type is one of the allowed options
+        if type not in ["primary", "secondary", "tertiary"]:
+            raise StreamlitAPIException(
+                'The type argument to st.popover must be "primary", "secondary", or "tertiary". '
+                f'\nThe argument passed was "{type}".'
+            )
+
         popover_proto = BlockProto.Popover()
         popover_proto.label = label
         popover_proto.disabled = disabled
+        popover_proto.type = type
         if help:
             popover_proto.help = str(help)
         if icon is not None: