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

streamlit/elements/lib/dialog.py

@@ -112,6 +112,7 @@ class Dialog(DeltaGenerator):
             element_id = compute_and_register_element_id(
                 "dialog",
                 user_key=None,
+                key_as_main_identity=False,
                 dg=parent,
                 title=title,
                 dismissible=dismissible,

streamlit/elements/lib/pandas_styler_utils.py

@@ -14,6 +14,7 @@
 
 from __future__ import annotations
 
+from collections import defaultdict
 from collections.abc import Mapping
 from typing import TYPE_CHECKING, Any, TypeVar
 
@@ -258,21 +259,36 @@ def _use_display_values(df: DataFrame, styles: Mapping[str, Any]) -> DataFrame:
     # If values in a column are not of the same type, Arrow
     # serialization would fail. Thus, we need to cast all values
     # of the dataframe to strings before assigning them display values.
-    new_df = df.astype(str)
 
+    new_df = df.astype(str)
     cell_selector_regex = re.compile(r"row(\d+)_col(\d+)")
-    if "body" in styles:
-        rows = styles["body"]
-        for row in rows:
-            for cell in row:
-                if "id" in cell and (match := cell_selector_regex.match(cell["id"])):
-                    r, c = map(int, match.groups())
-                    # Check if the display value is an Enum type. Enum values need to be
-                    # converted to their `.value` attribute to ensure proper serialization
-                    # and display logic.
-                    if isinstance(cell["display_value"], Enum):
-                        new_df.iloc[r, c] = str(cell["display_value"].value)
-                    else:
-                        new_df.iloc[r, c] = str(cell["display_value"])
+    # Outer key = column index; inner key = row index -> target string value
+    updates_by_col: defaultdict[int, dict[int, str]] = defaultdict(dict)
+    for row in styles.get("body", []):
+        for cell in row:
+            cell_id = cell.get("id")
+            if not cell_id:
+                continue
+            match = cell_selector_regex.match(cell_id)
+            if not match:
+                continue
+            row_idx, col_idx = map(int, match.groups())
+            display_value = cell.get("display_value")
+
+            str_value = (
+                str(display_value.value)
+                # Check if the display value is an Enum type. Enum values need to be
+                # converted to their `.value` attribute to ensure proper serialization
+                # and display logic.
+                if isinstance(display_value, Enum)
+                else str(display_value)
+            )
+            updates_by_col[col_idx][row_idx] = str_value
+
+    for col_idx, values_by_row in updates_by_col.items():
+        row_indices = list(values_by_row.keys())
+        values = list(values_by_row.values())
+        # Batch-assign updates for this column using iloc for performance.
+        new_df.iloc[row_indices, col_idx] = values
 
     return new_df

streamlit/elements/lib/utils.py

@@ -187,7 +187,7 @@ def compute_and_register_element_id(
     *,
     user_key: str | None,
     dg: DeltaGenerator | None,
-    key_as_main_identity: bool = False,
+    key_as_main_identity: bool | set[str],
     **kwargs: SAFE_VALUES | Iterable[SAFE_VALUES],
 ) -> str:
     """Compute and register the ID for the given element.
@@ -224,15 +224,27 @@ def compute_and_register_element_id(
         format_func, label_visibility, args, kwargs, on_change, and
         the active_script_hash are not supposed to be added here
 
-    key_as_main_identity : bool
-        If True, if a key is provided by the user, we don't include
+    key_as_main_identity : bool | set[str]
+        If True and a key is provided by the user, we don't include
         command kwargs in the element ID computation.
+        If a set of kwarg names is provided and a key is provided,
+        only the kwargs with names in this set will be included
+        in the element ID computation.
     """
     ctx = get_script_run_ctx()
 
-    ignore_command_kwargs = key_as_main_identity and user_key
+    # When a user_key is present and key_as_main_identity is True OR a set (even empty),
+    # we should ignore general command kwargs and form/sidebar context. For the set case,
+    # only explicitly whitelisted kwargs will be included below.
+    ignore_command_kwargs = user_key is not None and (
+        (key_as_main_identity is True) or isinstance(key_as_main_identity, set)
+    )
 
-    kwargs_to_use = {} if ignore_command_kwargs else {**kwargs}
+    if isinstance(key_as_main_identity, set) and user_key:
+        # Only include the explicitly whitelisted kwargs in the computation
+        kwargs_to_use = {k: v for k, v in kwargs.items() if k in key_as_main_identity}
+    else:
+        kwargs_to_use = {} if ignore_command_kwargs else {**kwargs}
 
     if ctx:
         # Add the active script hash to give elements on different

streamlit/elements/map.py

@@ -399,9 +399,7 @@ def _convert_color_arg_or_column(
 
     if color_col_name is not None:
         # Convert color column to the right format.
-        if len(data[color_col_name]) > 0 and is_color_like(
-            data[color_col_name].iloc[0]
-        ):
+        if len(data[color_col_name]) > 0 and is_color_like(data[color_col_name].iat[0]):
             # Use .loc[] to avoid a SettingWithCopyWarning in some cases.
             data.loc[:, color_col_name] = data.loc[:, color_col_name].map(
                 to_int_color_tuple

streamlit/elements/media.py

@@ -639,6 +639,7 @@ def marshall_video(
             "video",
             # video does not yet allow setting a user-defined key
             user_key=None,
+            key_as_main_identity=False,
             dg=dg,
             url=proto.url,
             mimetype=mimetype,
@@ -831,6 +832,7 @@ def marshall_audio(
         proto.id = compute_and_register_element_id(
             "audio",
             user_key=None,
+            key_as_main_identity=False,
             dg=dg,
             url=proto.url,
             mimetype=mimetype,

streamlit/elements/metric.py

@@ -36,16 +36,14 @@ from streamlit.elements.lib.utils import (
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.Metric_pb2 import Metric as MetricProto
 from streamlit.runtime.metrics_util import gather_metrics
-from streamlit.string_util import clean_text
+from streamlit.string_util import AnyNumber, clean_text, from_number
 
 if TYPE_CHECKING:
-    import numpy as np
-
     from streamlit.delta_generator import DeltaGenerator
 
 
-Value: TypeAlias = Union["np.integer[Any]", "np.floating[Any]", float, int, str, None]
-Delta: TypeAlias = Union[float, int, str, None]
+Value: TypeAlias = Union[AnyNumber, str, None]
+Delta: TypeAlias = Union[AnyNumber, str, None]
 DeltaColor: TypeAlias = Literal["normal", "inverse", "off"]
 
 
@@ -98,10 +96,10 @@ class MetricMixin:
             .. |st.markdown| replace:: ``st.markdown``
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
 
-        value : int, float, str, or None
-             Value of the metric. None is rendered as a long dash.
+        value : int, float, decimal.Decimal, str, or None
+             Value of the metric. ``None`` is rendered as a long dash.
 
-        delta : int, float, str, or None
+        delta : int, float, decimal.Decimal, str, or None
             Indicator of how the metric changed, rendered with an arrow below
             the metric. If delta is negative (int/float) or starts with a minus
             sign (str), the arrow points down and the text is red; else the
@@ -338,23 +336,9 @@ def _parse_label(label: str) -> str:
 def _parse_value(value: Value) -> str:
     if value is None:
         return "—"
-    if isinstance(value, (int, float, str)):
-        return str(value)
-    if hasattr(value, "item"):
-        # Add support for numpy values (e.g. int16, float64, etc.)
-        try:
-            # Item could also be just a variable, so we use try, except
-            if isinstance(value.item(), (float, int)):
-                return str(value.item())
-        except Exception:  # noqa: S110
-            # If the numpy item is not a valid value, the TypeError below will be raised.
-            pass
-
-    raise TypeError(
-        f"'{value}' is of type {type(value)}, which is not an accepted type."
-        " value only accepts: int, float, str, or None."
-        " Please convert the value to an accepted type."
-    )
+    if isinstance(value, str):
+        return value
+    return from_number(value)
 
 
 def _parse_delta(delta: Delta) -> str:
@@ -362,13 +346,7 @@ def _parse_delta(delta: Delta) -> str:
         return ""
     if isinstance(delta, str):
         return dedent(delta)
-    if isinstance(delta, (int, float)):
-        return str(delta)
-    raise TypeError(
-        f"'{delta}' is of type {type(delta)}, which is not an accepted type."
-        " delta only accepts: int, float, str, or None."
-        " Please convert the value to an accepted type."
-    )
+    return from_number(delta)
 
 
 def _determine_delta_color_and_direction(

streamlit/elements/plotly_chart.py

@@ -316,6 +316,7 @@ class PlotlyMixin:
             "box",
             "lasso",
         ),
+        config: dict[str, Any] | None = None,
         **kwargs: Any,
     ) -> DeltaGenerator | PlotlyState:
         """Display an interactive Plotly chart.
@@ -415,6 +416,12 @@ class PlotlyMixin:
 
             All selections modes are activated by default.
 
+        config : dict or None
+            A dictionary of Plotly configuration options. This is passed to
+            Plotly's ``show()`` function. For more information about Plotly
+            configuration options, see Plotly's documentation on `Configuration
+            in Python <https://plotly.com/python/configuration-options/>`_.
+
         **kwargs
             Additional arguments accepted by Plotly's ``plot()`` function.
 
@@ -423,6 +430,10 @@ class PlotlyMixin:
             see Plotly's documentation on `Configuration in Python
             <https://plotly.com/python/configuration-options/>`_.
 
+            .. deprecated::
+               ``**kwargs`` are deprecated and will be removed in a future
+               release. Use ``config`` instead.
+
         Returns
         -------
         element or dict
@@ -493,11 +504,11 @@ class PlotlyMixin:
         # for their main parameter. I don't like the name, but it's best to
         # keep it in sync with what Plotly calls it.
 
-        if "sharing" in kwargs:
+        if kwargs:
             show_deprecation_warning(
-                "The `sharing` parameter has been deprecated and will be removed "
-                "in a future release. Plotly charts will always be rendered using "
-                "Streamlit's offline mode."
+                "The keyword arguments have been deprecated and will be removed "
+                "in a future release. Use `config` instead to specify Plotly "
+                "configuration options."
             )
 
         if theme not in ["streamlit", None]:
@@ -542,11 +553,7 @@ class PlotlyMixin:
         plotly_chart_proto.theme = theme or ""
         plotly_chart_proto.form_id = current_form_id(self.dg)
 
-        config = dict(kwargs.get("config", {}))
-        # Copy over some kwargs to config dict. Plotly does the same in plot().
-        config.setdefault("showLink", kwargs.get("show_link", False))
-        config.setdefault("linkText", kwargs.get("link_text", False))
-
+        config = config or {}
         plotly_chart_proto.spec = plotly.io.to_json(figure, validate=False)
         plotly_chart_proto.config = json.dumps(config)
 
@@ -558,6 +565,7 @@ class PlotlyMixin:
         plotly_chart_proto.id = compute_and_register_element_id(
             "plotly_chart",
             user_key=key,
+            key_as_main_identity=False,
             dg=self.dg,
             plotly_spec=plotly_chart_proto.spec,
             plotly_config=plotly_chart_proto.config,

streamlit/elements/pyplot.py

@@ -99,15 +99,15 @@ class PyplotMixin:
             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"``. For ``use_container_width=False``, use
+                ``width="content"``.
+
         **kwargs : any
             Arguments to pass to Matplotlib's savefig function.
 
-        .. 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 matplotlib.pyplot as plt

streamlit/elements/vega_charts.py

@@ -20,20 +20,15 @@ import json
 import re
 from contextlib import nullcontext
 from dataclasses import dataclass
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Final,
-    Literal,
-    TypedDict,
-    Union,
-    cast,
-    overload,
-)
+from typing import TYPE_CHECKING, Any, Final, Literal, TypedDict, Union, cast, overload
 
 from typing_extensions import Required, TypeAlias
 
 from streamlit import dataframe_util, type_util
+from streamlit.deprecation_util import (
+    make_deprecated_name_warning,
+    show_deprecation_warning,
+)
 from streamlit.elements.lib import dicttools
 from streamlit.elements.lib.built_in_chart_utils import (
     AddRowsMetadata,
@@ -43,6 +38,13 @@ from streamlit.elements.lib.built_in_chart_utils import (
     maybe_raise_stack_warning,
 )
 from streamlit.elements.lib.form_utils import current_form_id
+from streamlit.elements.lib.layout_utils import (
+    Height,
+    LayoutConfig,
+    Width,
+    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
@@ -596,9 +598,9 @@ class VegaChartsMixin:
         x_label: str | None = None,
         y_label: str | None = None,
         color: str | Color | list[Color] | None = None,
-        width: int | None = None,
-        height: int | None = None,
-        use_container_width: bool = True,
+        width: Width = "stretch",
+        height: Height = "content",
+        use_container_width: bool | None = None,
     ) -> DeltaGenerator:
         """Display a line chart.
 
@@ -607,9 +609,6 @@ class VegaChartsMixin:
         the chart's Altair spec. As a result this is easier to use for many
         "just plot this" scenarios, while being less customizable.
 
-        If ``st.line_chart`` does not guess the data specification
-        correctly, try specifying your desired chart using ``st.altair_chart``.
-
         Parameters
         ----------
         data : Anything supported by st.dataframe
@@ -680,20 +679,30 @@ class VegaChartsMixin:
             You can set the default colors in the ``theme.chartCategoryColors``
             configuration option.
 
-        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``.
+        width : "stretch", "content", or int
+            The width of the chart element. This can be one of the following:
 
-        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.
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - ``"content"``: The width of the element matches the width of its
+              content, but doesn't exceed 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.
+
+        height : "content", "stretch", or int
+            The height of the chart element. This can be one of the following:
+
+            - ``"content"`` (default): The height of the element matches the
+              height of its content.
+            - ``"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.
+            - 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.
 
         use_container_width : bool
             Whether to override ``width`` with the width of the parent
@@ -702,6 +711,11 @@ class VegaChartsMixin:
             parent container. If ``use_container_width`` is ``False``,
             Streamlit sets the chart's width according to ``width``.
 
+            .. deprecated::
+                The ``use_container_width`` parameter is deprecated and will
+                be removed in a future version. Use the ``width`` parameter
+                with ``width="stretch"`` instead.
+
         Examples
         --------
         **Example 1: Basic line chart from a dataframe**
@@ -777,6 +791,24 @@ class VegaChartsMixin:
            height: 440px
 
         """
+        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`, use `width='content'`.",
+                    include_st_prefix=False,
+                ),
+                show_in_browser=False,
+            )
+            if use_container_width:
+                width = "stretch"
+            elif not isinstance(width, int):
+                # This preserves the existing behavior of setting use_container_width
+                # to False combined with an integer width.
+                width = "content"
 
         chart, add_rows_metadata = generate_chart(
             chart_type=ChartType.LINE,
@@ -789,15 +821,19 @@ class VegaChartsMixin:
             size_from_user=None,
             width=width,
             height=height,
-            use_container_width=use_container_width,
+            use_container_width=(width == "stretch"),
         )
+
+        validate_width(width, allow_content=True)
+        validate_height(height, allow_content=True)
         return cast(
             "DeltaGenerator",
             self._altair_chart(
                 chart,
-                use_container_width=use_container_width,
                 theme="streamlit",
                 add_rows_metadata=add_rows_metadata,
+                width=width,
+                height=height,
             ),
         )
 
@@ -823,9 +859,6 @@ class VegaChartsMixin:
         the chart's Altair spec. As a result this is easier to use for many
         "just plot this" scenarios, while being less customizable.
 
-        If ``st.area_chart`` does not guess the data specification
-        correctly, try specifying your desired chart using ``st.altair_chart``.
-
         Parameters
         ----------
         data : Anything supported by st.dataframe
@@ -1082,6 +1115,7 @@ class VegaChartsMixin:
         y_label: str | None = None,
         color: str | Color | list[Color] | None = None,
         horizontal: bool = False,
+        sort: bool | str = True,
         stack: bool | ChartStackType | None = None,
         width: int | None = None,
         height: int | None = None,
@@ -1094,9 +1128,6 @@ class VegaChartsMixin:
         the chart's Altair spec. As a result this is easier to use for many
         "just plot this" scenarios, while being less customizable.
 
-        If ``st.bar_chart`` does not guess the data specification
-        correctly, try specifying your desired chart using ``st.altair_chart``.
-
         Parameters
         ----------
         data : Anything supported by st.dataframe
@@ -1173,6 +1204,19 @@ class VegaChartsMixin:
             Streamlit swaps the x-axis and y-axis and the bars display
             horizontally.
 
+        sort : bool or str
+            How to sort the bars. This can be one of the following:
+
+            - ``True`` (default): The bars are sorted automatically along the
+              independent/categorical axis with Altair's default sorting. This
+              also correctly sorts ordered categorical columns
+              (``pd.Categorical``).
+            - ``False``: The bars are shown in data order without sorting.
+            - The name of a column (e.g. ``"col1"``): The bars are sorted by
+              that column in ascending order.
+            - The name of a column with a minus-sign prefix (e.g. ``"-col1"``):
+              The bars are sorted by that column in descending order.
+
         stack : bool, "normalize", "center", "layered", or None
             Whether to stack the bars. If this is ``None`` (default),
             Streamlit uses Vega's default. Other values can be as follows:
@@ -1357,6 +1401,7 @@ class VegaChartsMixin:
             use_container_width=use_container_width,
             stack=stack,
             horizontal=horizontal,
+            sort_from_user=sort,
         )
         return cast(
             "DeltaGenerator",
@@ -1390,9 +1435,6 @@ class VegaChartsMixin:
         the chart's Altair spec. As a result this is easier to use for many
         "just plot this" scenarios, while being less customizable.
 
-        If ``st.scatter_chart`` does not guess the data specification correctly,
-        try specifying your desired chart using ``st.altair_chart``.
-
         Parameters
         ----------
         data : Anything supported by st.dataframe
@@ -1956,6 +1998,8 @@ class VegaChartsMixin:
         on_select: Literal["rerun", "ignore"] | WidgetCallback = "ignore",
         selection_mode: str | Iterable[str] | None = None,
         add_rows_metadata: AddRowsMetadata | None = None,
+        width: Width | None = None,
+        height: Height | None = None,
     ) -> DeltaGenerator | VegaLiteState:
         """Internal method to enqueue a vega-lite chart element based on an Altair chart.
 
@@ -1980,6 +2024,8 @@ class VegaChartsMixin:
             on_select=on_select,
             selection_mode=selection_mode,
             add_rows_metadata=add_rows_metadata,
+            width=width,
+            height=height,
         )
 
     def _vega_lite_chart(
@@ -1992,6 +2038,8 @@ class VegaChartsMixin:
         on_select: Literal["rerun", "ignore"] | WidgetCallback = "ignore",
         selection_mode: str | Iterable[str] | None = None,
         add_rows_metadata: AddRowsMetadata | None = None,
+        width: Width | None = None,
+        height: Height | None = None,
         **kwargs: Any,
     ) -> DeltaGenerator | VegaLiteState:
         """Internal method to enqueue a vega-lite chart element based on a vega-lite spec.
@@ -2038,13 +2086,13 @@ class VegaChartsMixin:
             spec = {}
 
         # Set the default value for `use_container_width`.
-        if use_container_width is None:
+        if use_container_width is None and width is None:
             # Some multi-view charts (facet, horizontal concatenation, and repeat;
             # see https://altair-viz.github.io/user_guide/compound_charts.html)
             # don't work well with `use_container_width=True`, so we disable it for
             # those charts (see https://github.com/streamlit/streamlit/issues/9091).
             # All other charts (including vertical concatenation) default to
-            # `use_container_width=True`.
+            # `use_container_width=True` unless width is provided.
             is_facet_chart = "facet" in spec or (
                 "encoding" in spec
                 and (any(x in spec["encoding"] for x in ["row", "column", "facet"]))
@@ -2055,12 +2103,18 @@ class VegaChartsMixin:
 
         vega_lite_proto = ArrowVegaLiteChartProto()
 
-        spec = _prepare_vega_lite_spec(spec, use_container_width, **kwargs)
+        use_container_width_for_spec = (
+            use_container_width
+            if use_container_width is not None
+            else width == "stretch"
+        )
+        spec = _prepare_vega_lite_spec(spec, use_container_width_for_spec, **kwargs)
         _marshall_chart_data(vega_lite_proto, spec, data)
 
         # Prevent the spec from changing across reruns:
         vega_lite_proto.spec = _stabilize_vega_json_spec(json.dumps(spec))
-        vega_lite_proto.use_container_width = use_container_width
+        if use_container_width is not None:
+            vega_lite_proto.use_container_width = use_container_width
         vega_lite_proto.theme = theme or ""
 
         if is_selection_activated:
@@ -2079,6 +2133,7 @@ class VegaChartsMixin:
             vega_lite_proto.id = compute_and_register_element_id(
                 "arrow_vega_lite_chart",
                 user_key=key,
+                key_as_main_identity=False,
                 dg=self.dg,
                 vega_lite_spec=vega_lite_proto.spec,
                 # The data is either in vega_lite_proto.data.data
@@ -2109,6 +2164,17 @@ class VegaChartsMixin:
                 add_rows_metadata=add_rows_metadata,
             )
             return widget_state.value
+
+        # Handle layout config for width/height parameters
+        if width is not None or height is not None:
+            layout_config = LayoutConfig(width=width, height=height)
+            return self.dg._enqueue(
+                "arrow_vega_lite_chart",
+                vega_lite_proto,
+                add_rows_metadata=add_rows_metadata,
+                layout_config=layout_config,
+            )
+
         # If its not used with selections activated, just return
         # the delta generator related to this element.
         return self.dg._enqueue(