streamlit 1.53.1__py3-none-any.whl → 1.54.0__py3-none-any.whl

streamlit/elements/lib/options_selector_utils.py

@@ -297,6 +297,7 @@ def validate_and_sync_value_with_options(
     This function has a side-effect: if the value is not found in the options
     and a key is provided, it will update session state with the new value.
 
+
     Parameters
     ----------
     current_value
@@ -321,29 +322,16 @@ def validate_and_sync_value_with_options(
     if current_value is None:
         return current_value, False
 
-    # For Enum values, use the original index_() approach which uses == comparison.
-    # This correctly handles enum class identity - enums from different classes
-    # (e.g., after script rerun) should NOT be considered equal, which is important
-    # for enum coercion to work correctly when coercion is disabled.
-    if isinstance(current_value, Enum):
-        try:
-            index_(opt, current_value)
-            return current_value, False
-        except ValueError:
-            pass  # Fall through to reset logic below
-    else:
-        # For non-Enum values, use format_func comparison. This handles custom objects
-        # without __eq__ where widget values are deepcopied and the deepcopied instances
-        # would fail identity comparison with ==.
-        try:
-            formatted_value = format_func(current_value)
-        except Exception:
-            # format_func failed - value is invalid
-            formatted_value = None
-
-        formatted_options_set = {format_func(o) for o in opt}
-        if formatted_value is not None and formatted_value in formatted_options_set:
+    # Use format_func comparison for all values. This correctly handles:
+    # - Custom objects without __eq__ (deepcopied instances)
+    # - Enum values (already from current class due to serde deserialization)
+    formatted_options_set = {format_func(o) for o in opt}
+    try:
+        formatted_value = format_func(current_value)
+        if formatted_value in formatted_options_set:
             return current_value, False
+    except Exception:  # noqa: S110
+        pass  # format_func failed - value is invalid, fall through to reset
 
     # Value not in options - reset to default
     if default_index is not None and len(opt) > 0:
@@ -424,3 +412,65 @@ def validate_and_sync_multiselect_value_with_options(
         get_session_state().reset_state_value(str(key), valid_values)
 
     return valid_values, True
+
+
+def validate_and_sync_range_value_with_options(
+    current_value: tuple[T, T],
+    opt: Sequence[T],
+    default_indices: list[int],
+    key: str | int | None,
+    format_func: Callable[[Any], str] = str,
+) -> tuple[tuple[T, T], bool]:
+    """Validate a range value (tuple of two values) against options.
+
+    If either value in the range is not found in options, the entire range is
+    reset to the default. This function has a side-effect: if the values are
+    invalid and a key is provided, it will update session state with the new value.
+
+    Parameters
+    ----------
+    current_value
+        The current range value (tuple of two values) to validate.
+    opt
+        The sequence of valid options.
+    default_indices
+        The default indices to reset to if value is invalid. Should contain
+        at least one index; if only one index is provided, the second default
+        will be the last option.
+    key
+        The widget key for session state updates.
+    format_func
+        Function to format options for comparison. Used to compare values by their
+        string representation instead of using == directly.
+
+    Returns
+    -------
+    tuple[tuple[T, T], bool]
+        A tuple of (validated_value, value_was_reset).
+    """
+    if len(opt) == 0:
+        return current_value, False
+
+    formatted_options_set = {format_func(o) for o in opt}
+
+    def is_valid(val: Any) -> bool:
+        """Check if a value exists in options via format_func comparison."""
+        try:
+            return format_func(val) in formatted_options_set
+        except Exception:
+            return False
+
+    def get_default_range() -> tuple[T, T]:
+        """Get the default range value."""
+        end_idx = default_indices[1] if len(default_indices) > 1 else len(opt) - 1
+        return (opt[default_indices[0]], opt[end_idx])
+
+    # Validate both values in the range.
+    if is_valid(current_value[0]) and is_valid(current_value[1]):
+        return current_value, False
+
+    # Either value is invalid - reset entire range.
+    new_value = get_default_range()
+    if key is not None:
+        get_session_state().reset_state_value(str(key), new_value)
+    return new_value, True

streamlit/elements/lib/policies.py

@@ -188,7 +188,7 @@ def maybe_raise_label_warnings(label: str | None, label_visibility: str | None)
             "if needed.",
             stack_info=True,
         )
-    if label_visibility not in ("visible", "hidden", "collapsed"):
+    if label_visibility not in {"visible", "hidden", "collapsed"}:
         raise errors.StreamlitAPIException(
             f"Unsupported label_visibility option '{label_visibility}'. "
             f"Valid values are 'visible', 'hidden' or 'collapsed'."

streamlit/elements/lib/streamlit_plotly_theme.py

@@ -58,7 +58,6 @@ DIVERGING_6: Final = "#000027"
 DIVERGING_7: Final = "#000028"
 DIVERGING_8: Final = "#000029"
 DIVERGING_9: Final = "#000030"
-DIVERGING_10: Final = "#000031"
 
 INCREASING: Final = "#000032"
 DECREASING: Final = "#000033"
@@ -189,16 +188,15 @@ def configure_streamlit_plotly_theme() -> None:
                     sequentialminus=streamlit_colorscale,
                     diverging=[
                         [0.0, DIVERGING_0],
-                        [0.1, DIVERGING_1],
-                        [0.2, DIVERGING_2],
-                        [0.3, DIVERGING_3],
-                        [0.4, DIVERGING_4],
-                        [0.5, DIVERGING_5],
-                        [0.6, DIVERGING_6],
-                        [0.7, DIVERGING_7],
-                        [0.8, DIVERGING_8],
-                        [0.9, DIVERGING_9],
-                        [1.0, DIVERGING_10],
+                        [0.1111111111111111, DIVERGING_1],
+                        [0.2222222222222222, DIVERGING_2],
+                        [0.3333333333333333, DIVERGING_3],
+                        [0.4444444444444444, DIVERGING_4],
+                        [0.5555555555555556, DIVERGING_5],
+                        [0.6666666666666666, DIVERGING_6],
+                        [0.7777777777777778, DIVERGING_7],
+                        [0.8888888888888888, DIVERGING_8],
+                        [1.0, DIVERGING_9],
                     ],
                 ),
                 coloraxis=go.layout.Coloraxis(colorscale=streamlit_colorscale),

streamlit/elements/lib/utils.py

@@ -59,10 +59,10 @@ SAFE_VALUES: TypeAlias = Union[
     time,
     datetime,
     timedelta,
-    None,
     "ellipsis",
     Message,
     PROTO_SCALAR_VALUE,
+    None,
 ]
 
 

streamlit/elements/map.py

@@ -93,8 +93,8 @@ class MapMixin:
         *,
         latitude: str | None = None,
         longitude: str | None = None,
-        color: None | str | Color = None,
-        size: None | str | float = None,
+        color: str | Color | None = None,
+        size: str | float | None = None,
         zoom: int | None = None,
         width: WidthWithoutContent = "stretch",
         height: HeightWithoutContent = 500,
@@ -296,8 +296,8 @@ def to_deckgl_json(
     data: Data,
     lat: str | None,
     lon: str | None,
-    size: None | str | float,
-    color: None | str | Collection[float],
+    size: str | float | None,
+    color: str | Collection[float] | None,
     zoom: int | None,
 ) -> str:
     if data is None:
@@ -432,7 +432,7 @@ def _convert_color_arg_or_column(
     data: DataFrame,
     color_arg: str,
     color_col_name: str | None,
-) -> None | str | IntColorTuple:
+) -> str | IntColorTuple | None:
     """Converts color to a format accepted by PyDeck.
 
     For example:
@@ -443,7 +443,7 @@ def _convert_color_arg_or_column(
     NOTE: This function mutates the data argument.
     """
 
-    color_arg_out: None | str | IntColorTuple = None
+    color_arg_out: str | IntColorTuple | None = None
 
     if color_col_name is not None:
         # Convert color column to the right format.

streamlit/elements/plotly_chart.py

@@ -677,14 +677,14 @@ class PlotlyMixin:
                 "options."
             )
 
-        if theme not in ["streamlit", None]:
+        if theme not in {"streamlit", None}:
             raise StreamlitAPIException(
                 f'You set theme="{theme}" while Streamlit charts only support '
                 "theme=”streamlit” or theme=None to fallback to the default "
                 "library theme."
             )
 
-        if on_select not in ["ignore", "rerun"] and not callable(on_select):
+        if on_select not in {"ignore", "rerun"} and not callable(on_select):
             raise StreamlitAPIException(
                 f"You have passed {on_select} to `on_select`. But only 'ignore', "
                 "'rerun', or a callable is supported."

streamlit/elements/toast.py

@@ -151,7 +151,7 @@ class ToastMixin:
         toast_proto.body = clean_text(validate_text(body))
         toast_proto.icon = validate_icon_or_emoji(icon)
 
-        if duration in ["short", "long", "infinite"] or (
+        if duration in {"short", "long", "infinite"} or (
             isinstance(duration, int) and duration > 0
         ):
             if duration == "short":

streamlit/elements/vega_charts.py

@@ -725,6 +725,10 @@ class VegaChartsMixin:
             - An RGB or RGBA tuple with the red, green, blue, and alpha
               components specified as ints from 0 to 255 or floats from 0.0 to
               1.0.
+            - A built-in color name: "red", "orange", "yellow", "green",
+              "blue", "violet", "gray"/"grey", or "primary". These map to
+              theme colors that you can customize using ``theme.<color>Color``
+              configuration options.
 
             For a line chart with multiple lines, where the dataframe is in
             long format (that is, y is None or just one column), this can be:
@@ -753,7 +757,8 @@ class VegaChartsMixin:
             - A list of string colors or color tuples to be used for each of
               the lines in the chart. This list should have the same length
               as the number of y values (e.g. ``color=["#fd0", "#f0f", "#04f"]``
-              for three lines).
+              for three lines). You can also use built-in color names in the
+              list (e.g. ``color=["red", "blue", "green"]``).
 
             You can set the default colors in the ``theme.chartCategoryColors``
             configuration option.
@@ -959,6 +964,10 @@ class VegaChartsMixin:
             - An RGB or RGBA tuple with the red, green, blue, and alpha
               components specified as ints from 0 to 255 or floats from 0.0 to
               1.0.
+            - A built-in color name: "red", "orange", "yellow", "green",
+              "blue", "violet", "gray"/"grey", or "primary". These map to
+              theme colors that you can customize using ``theme.<color>Color``
+              configuration options.
 
             For an area chart with multiple series, where the dataframe is in
             long format (that is, y is None or just one column), this can be:
@@ -987,7 +996,8 @@ class VegaChartsMixin:
             - A list of string colors or color tuples to be used for each of
               the series in the chart. This list should have the same length
               as the number of y values (e.g. ``color=["#fd0", "#f0f", "#04f"]``
-              for three lines).
+              for three lines). You can also use built-in color names in the
+              list (e.g. ``color=["red", "blue", "green"]``).
 
             You can set the default colors in the ``theme.chartCategoryColors``
             configuration option.
@@ -1248,6 +1258,10 @@ class VegaChartsMixin:
             - An RGB or RGBA tuple with the red, green, blue, and alpha
               components specified as ints from 0 to 255 or floats from 0.0 to
               1.0.
+            - A built-in color name: "red", "orange", "yellow", "green",
+              "blue", "violet", "gray"/"grey", or "primary". These map to
+              theme colors that you can customize using ``theme.<color>Color``
+              configuration options.
 
             For a bar chart with multiple series, where the dataframe is in
             long format (that is, y is None or just one column), this can be:
@@ -1276,7 +1290,8 @@ class VegaChartsMixin:
             - A list of string colors or color tuples to be used for each of
               the series in the chart. This list should have the same length
               as the number of y values (e.g. ``color=["#fd0", "#f0f", "#04f"]``
-              for three lines).
+              for three lines). You can also use built-in color names in the
+              list (e.g. ``color=["red", "blue", "green"]``).
 
             You can set the default colors in the ``theme.chartCategoryColors``
             configuration option.
@@ -1575,6 +1590,10 @@ class VegaChartsMixin:
             - An RGB or RGBA tuple with the red, green, blue, and alpha
               components specified as ints from 0 to 255 or floats from 0.0 to
               1.0.
+            - A built-in color name: "red", "orange", "yellow", "green",
+              "blue", "violet", "gray"/"grey", or "primary". These map to
+              theme colors that you can customize using ``theme.<color>Color``
+              configuration options.
             - The name of a column in the dataset where the color of that
               datapoint will come from.
 
@@ -1602,7 +1621,8 @@ class VegaChartsMixin:
             - A list of string colors or color tuples to be used for each of
               the series in the chart. This list should have the same length
               as the number of y values (e.g. ``color=["#fd0", "#f0f", "#04f"]``
-              for three series).
+              for three series). You can also use built-in color names in the
+              list (e.g. ``color=["red", "blue", "green"]``).
 
         size : str, float, int, or None
             The size of the circles representing each point.
@@ -2282,14 +2302,14 @@ class VegaChartsMixin:
 
         See the `vega_lite_chart` method docstring for more information.
         """
-        if theme not in ["streamlit", None]:
+        if theme not in {"streamlit", None}:
             raise StreamlitAPIException(
                 f'You set theme="{theme}" while Streamlit charts only support '
                 "theme=”streamlit” or theme=None to fallback to the default "
                 "library theme."
             )
 
-        if on_select not in ["ignore", "rerun"] and not callable(on_select):
+        if on_select not in {"ignore", "rerun"} and not callable(on_select):
             raise StreamlitAPIException(
                 f"You have passed {on_select} to `on_select`. But only 'ignore', "
                 "'rerun', or a callable is supported."
@@ -2404,7 +2424,10 @@ class VegaChartsMixin:
             vega_lite_proto.id = compute_and_register_element_id(
                 "arrow_vega_lite_chart",
                 user_key=key,
-                key_as_main_identity=False,
+                # There are some edge cases where selections can become orphaned when the data changes.
+                #  The frontend can handle this without errors, but it might be a nice enhancement
+                # to automatically reset the backend & frontend selection state in this case.
+                key_as_main_identity={"selection_mode"},
                 dg=self.dg,
                 vega_lite_spec=vega_lite_proto.spec,
                 # The data is either in vega_lite_proto.data.data

streamlit/elements/widgets/button.py

@@ -356,7 +356,7 @@ class ButtonMixin:
             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"]:
+        if type not in {"primary", "secondary", "tertiary"}:
             raise StreamlitAPIException(
                 'The type argument to st.button must be "primary", "secondary", or "tertiary". '
                 f'\nThe argument passed was "{type}".'
@@ -736,7 +736,7 @@ class ButtonMixin:
         if use_container_width is not None:
             width = "stretch" if use_container_width else "content"
 
-        if type not in ["primary", "secondary", "tertiary"]:
+        if type not in {"primary", "secondary", "tertiary"}:
             raise StreamlitAPIException(
                 'The type argument to st.download_button must be "primary", "secondary", or "tertiary". \n'
                 f'The argument passed was "{type}".'
@@ -915,7 +915,7 @@ class ButtonMixin:
 
         """
         # Checks whether the entered button type is one of the allowed options - either "primary" or "secondary"
-        if type not in ["primary", "secondary", "tertiary"]:
+        if type not in {"primary", "secondary", "tertiary"}:
             raise StreamlitAPIException(
                 'The type argument to st.link_button must be "primary", "secondary", or "tertiary". '
                 f'\nThe argument passed was "{type}".'

streamlit/elements/widgets/button_group.py

@@ -255,7 +255,7 @@ def _build_proto(
 
 def _maybe_raise_selection_mode_warning(selection_mode: SelectionMode) -> None:
     """Check if the selection_mode value is valid or raise exception otherwise."""
-    if selection_mode not in ["single", "multi"]:
+    if selection_mode not in {"single", "multi"}:
         raise StreamlitAPIException(
             "The selection_mode argument must be one of ['single', 'multi']. "
             f"The argument passed was '{selection_mode}'."
@@ -410,7 +410,7 @@ class ButtonGroupMixin:
 
         """
 
-        if options not in ["thumbs", "faces", "stars"]:
+        if options not in {"thumbs", "faces", "stars"}:
             raise StreamlitAPIException(
                 "The options argument to st.feedback must be one of "
                 "['thumbs', 'faces', 'stars']. "
@@ -1062,7 +1062,7 @@ class ButtonGroupMixin:
                 "`selection_mode='single'`."
             )
 
-        if style not in ["borderless", "pills", "segmented_control"]:
+        if style not in {"borderless", "pills", "segmented_control"}:
             raise StreamlitAPIException(
                 "The style argument must be one of ['borderless', 'pills', 'segmented_control']. "
                 f"The argument passed was '{style}'."

streamlit/elements/widgets/chat.py

@@ -223,7 +223,7 @@ def _process_avatar_input(
             AvatarType.ICON,
             (
                 "assistant"
-                if avatar in [PresetNames.AI, PresetNames.ASSISTANT]
+                if avatar in {PresetNames.AI, PresetNames.ASSISTANT}
                 else "user"
             ),
         )

streamlit/elements/widgets/data_editor.py

@@ -238,11 +238,11 @@ def _parse_value(
         if column_data_kind == ColumnDataKind.TIMEDELTA:
             return pd.Timedelta(value)
 
-        if column_data_kind in [
+        if column_data_kind in {
             ColumnDataKind.DATETIME,
             ColumnDataKind.DATE,
             ColumnDataKind.TIME,
-        ]:
+        }:
             datetime_value = pd.Timestamp(value)
 
             if pd.isna(datetime_value):
@@ -481,7 +481,7 @@ def _is_supported_index(df_index: pd.Index[Any]) -> bool:
 
     return (
         type(df_index)
-        in [
+        in {
             pd.RangeIndex,
             pd.Index,
             pd.DatetimeIndex,
@@ -490,7 +490,7 @@ def _is_supported_index(df_index: pd.Index[Any]) -> bool:
             # pd.IntervalIndex,
             # Period type isn't editable currently:
             # pd.PeriodIndex,
-        ]
+        }
         # We need to check these index types without importing, since they are
         # deprecated and planned to be removed soon.
         or is_type(df_index, "pandas.core.indexes.numeric.Int64Index")
@@ -1029,7 +1029,7 @@ class DataEditorMixin:
             update_column_config(
                 column_config_mapping, INDEX_IDENTIFIER, {"required": True}
             )
-            if num_rows in ("dynamic", "add") and hide_index is True:
+            if num_rows in {"dynamic", "add"} and hide_index is True:
                 _LOGGER.warning(
                     "Setting `hide_index=True` in data editor with a non-range index will not have any effect "
                     "when `num_rows` is '%s'. It is required for the user to fill in index values for "
@@ -1038,7 +1038,7 @@ class DataEditorMixin:
                     num_rows,
                 )
 
-        if hide_index is None and has_range_index and num_rows in ("dynamic", "add"):
+        if hide_index is None and has_range_index and num_rows in {"dynamic", "add"}:
             # Temporary workaround:
             # We hide range indices if num_rows allows adding rows.
             # since the current way of handling this index during editing is a

streamlit/elements/widgets/multiselect.py

@@ -270,7 +270,7 @@ class MultiSelectMixin:
         placeholder: str | None = None,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
-        accept_new_options: Literal[False, True] | bool = False,
+        accept_new_options: bool = False,
         width: WidthWithoutContent = "stretch",
     ) -> list[T] | list[T | str]:
         r"""Display a multiselect widget.

streamlit/elements/widgets/number_input.py

@@ -512,7 +512,7 @@ class NumberInputMixin:
         number_format = ("%d" if int_value else "%0.2f") if format is None else format
 
         # Warn user if they format an int type as a float or vice versa.
-        if number_format in ["%d", "%u", "%i"] and float_value:
+        if number_format in {"%d", "%u", "%i"} and float_value:
             import streamlit as st
 
             st.warning(