streamlit-nightly 1.37.2.dev20240819__py2.py3-none-any.whl → 1.37.2.dev20240822__py2.py3-none-any.whl

streamlit/elements/arrow.py

@@ -271,21 +271,46 @@ class ArrowMixin:
     ) -> DeltaGenerator | DataframeState:
         """Display a dataframe as an interactive table.
 
-        This command works with dataframes from Pandas, PyArrow, Snowpark, and PySpark.
-        It can also display several other types that can be converted to dataframes,
-        e.g. numpy arrays, lists, sets and dictionaries.
+        This command works with a wide variety of collection-like and
+        dataframe-like object types.
 
         Parameters
         ----------
-        data : pandas.DataFrame, pandas.Series, pandas.Styler, pandas.Index, \
-            pyarrow.Table, numpy.ndarray, pyspark.sql.DataFrame, snowflake.snowpark.dataframe.DataFrame, \
-            snowflake.snowpark.table.Table, Iterable, dict, or None
+        data : dataframe-like, collection-like, or None
             The data to display.
 
+            Dataframe-like objects include dataframe and series objects from
+            popular libraries like Dask, Modin, Numpy, pandas, Polars, PyArrow,
+            Snowpark, Xarray, and more. You can use database cursors and
+            clients that comply with the
+            `Python Database API Specification v2.0 (PEP 249)
+            <https://peps.python.org/pep-0249/>`_. Additionally, you can use
+            anything that supports the `Python dataframe interchange protocol
+            <https://data-apis.org/dataframe-protocol/latest/>`_.
+
+            For example, you can use the following:
+
+            - ``pandas.DataFrame``, ``pandas.Series``, ``pandas.Index``,
+              ``pandas.Styler``, and ``pandas.Array``
+            - ``polars.DataFrame``, ``polars.LazyFrame``, and ``polars.Series``
+            - ``snowflake.snowpark.dataframe.DataFrame``,
+              ``snowflake.snowpark.table.Table``
+
+            If a dataype is not recognized, Streamlit will convert the object
+            to a ``pandas.DataFrame`` or ``pyarrow.Table`` using a
+            ``.to_pandas()`` or ``.to_arrow()`` method, respectively, if
+            available.
+
             If ``data`` is a ``pandas.Styler``, it will be used to style its
             underlying ``pandas.DataFrame``. Streamlit supports custom cell
             values and colors. It does not support some of the more exotic
-            pandas styling features, like bar charts, hovering, and captions.
+            styling options, like bar charts, hovering, and captions. For
+            these styling options, use column configuration instead.
+
+            Collection-like objects include all Python-native ``Collection``
+            types, such as ``dict``, ``list``, and ``set``.
+
+            If ``data`` is ``None``, Streamlit renders an empty table.
 
         width : int or None
             Desired width of the dataframe expressed in pixels. If ``width`` is
@@ -581,7 +606,7 @@ class ArrowMixin:
 
         Parameters
         ----------
-        data : pandas.DataFrame, pandas.Styler, pyarrow.Table, numpy.ndarray, pyspark.sql.DataFrame, snowflake.snowpark.dataframe.DataFrame, snowflake.snowpark.table.Table, Iterable, dict, or None
+        data : Anything supported by st.dataframe
             The table data.
 
         Example

streamlit/elements/code.py

@@ -31,7 +31,9 @@ class CodeMixin:
         self,
         body: SupportsStr,
         language: str | None = "python",
+        *,
         line_numbers: bool = False,
+        wrap_lines: bool = False,
     ) -> DeltaGenerator:
         """Display a code block with optional syntax highlighting.
 
@@ -52,6 +54,10 @@ class CodeMixin:
             An optional boolean indicating whether to show line numbers to the
             left of the code block. Defaults to ``False``.
 
+        wrap_lines : bool
+            An optional boolean indicating whether to wrap lines. Defaults
+            to ``False``.
+
         Example
         -------
         >>> import streamlit as st
@@ -65,6 +71,7 @@ class CodeMixin:
         code_proto.code_text = clean_text(body)
         code_proto.language = language or "plaintext"
         code_proto.show_line_numbers = line_numbers
+        code_proto.wrap_lines = wrap_lines
         return self.dg._enqueue("code", code_proto)
 
     @property

streamlit/elements/image.py

@@ -25,7 +25,7 @@ import io
 import os
 import re
 from enum import IntEnum
-from typing import TYPE_CHECKING, Final, List, Literal, Sequence, Union, cast
+from typing import TYPE_CHECKING, Final, Literal, Sequence, Union, cast
 
 from typing_extensions import TypeAlias
 
@@ -54,7 +54,7 @@ PILImage: TypeAlias = Union[
     "ImageFile.ImageFile", "Image.Image", "GifImagePlugin.GifImageFile"
 ]
 AtomicImage: TypeAlias = Union[PILImage, "npt.NDArray[Any]", io.BytesIO, str, bytes]
-ImageOrImageList: TypeAlias = Union[AtomicImage, List[AtomicImage]]
+ImageOrImageList: TypeAlias = Union[AtomicImage, Sequence[AtomicImage]]
 UseColumnWith: TypeAlias = Union[Literal["auto", "always", "never"], bool, None]
 Channels: TypeAlias = Literal["RGB", "BGR"]
 ImageFormat: TypeAlias = Literal["JPEG", "PNG", "GIF"]
@@ -178,14 +178,11 @@ class ImageMixin:
 
 
 def _image_may_have_alpha_channel(image: PILImage) -> bool:
-    if image.mode in ("RGBA", "LA", "P"):
-        return True
-    else:
-        return False
+    return image.mode in ("RGBA", "LA", "P")
 
 
 def _image_is_gif(image: PILImage) -> bool:
-    return bool(image.format == "GIF")
+    return image.format == "GIF"
 
 
 def _validate_image_format_string(
@@ -199,7 +196,7 @@ def _validate_image_format_string(
     "GIF" if the image is a GIF, and "JPEG" otherwise.
     """
     format = format.upper()
-    if format == "JPEG" or format == "PNG":
+    if format in {"JPEG", "PNG"}:
         return cast(ImageFormat, format)
 
     # We are forgiving on the spelling of JPEG
@@ -509,30 +506,23 @@ def marshall_images(
 
     # Turn single image and caption into one element list.
     images: Sequence[AtomicImage]
-    if isinstance(image, list):
-        images = image
+    if isinstance(image, (list, set, tuple)):
+        images = list(image)
     elif isinstance(image, np.ndarray) and len(cast(NumpyShape, image.shape)) == 4:
         images = _4d_to_list_3d(image)
     else:
-        images = [image]
+        images = [image]  # type: ignore
 
     if isinstance(caption, list):
         captions: Sequence[str | None] = caption
+    elif isinstance(caption, str):
+        captions = [caption]
+    elif isinstance(caption, np.ndarray) and len(cast(NumpyShape, caption.shape)) == 1:
+        captions = caption.tolist()
+    elif caption is None:
+        captions = [None] * len(images)
     else:
-        if isinstance(caption, str):
-            captions = [caption]
-        # You can pass in a 1-D Numpy array as captions.
-        elif (
-            isinstance(caption, np.ndarray)
-            and len(cast(NumpyShape, caption.shape)) == 1
-        ):
-            captions = caption.tolist()
-        # If there are no captions then make the captions list the same size
-        # as the images list.
-        elif caption is None:
-            captions = [None] * len(images)
-        else:
-            captions = [str(caption)]
+        captions = [str(caption)]
 
     assert isinstance(
         captions, list

streamlit/elements/json.py

@@ -46,7 +46,7 @@ class JsonMixin:
         *,  # keyword-only arguments:
         expanded: bool | int = True,
     ) -> DeltaGenerator:
-        """Display object or string as a pretty-printed JSON string.
+        """Display an object or string as a pretty-printed, interactive JSON string.
 
         Parameters
         ----------
@@ -57,10 +57,17 @@ class JsonMixin:
             contains serialized JSON.
 
         expanded : bool or int
-            Controls the initial expansion state of the json element.
-            If bool, ``True`` expands all levels, ``False`` collapses all levels.
-            If int, specifies the depth to which the json should be expanded,
-            collapsing deeper levels. Defaults to ``True``.
+            The initial expansion state of the JSON element. This can be one
+            of the following:
+
+            - ``True`` (default): The element is fully expanded.
+            - ``False``: The element is fully collapsed.
+            - An integer: The element is expanded to the depth specified. The
+              integer must be non-negative. ``expanded=0`` is equivalent to
+              ``expanded=False``.
+
+            Regardless of the initial expansion state, users can collapse or
+            expand any key-value pair to show or hide any part of the object.
 
         Example
         -------

streamlit/elements/lib/column_types.py

@@ -448,7 +448,7 @@ def TextColumn(
     >>>             help="Streamlit **widget** commands 🎈",
     >>>             default="st.",
     >>>             max_chars=50,
-    >>>             validate="^st\.[a-z_]+$",
+    >>>             validate=r"^st\.[a-z_]+$",
     >>>         )
     >>>     },
     >>>     hide_index=True,
@@ -571,9 +571,9 @@ def LinkColumn(
     >>>         "apps": st.column_config.LinkColumn(
     >>>             "Trending apps",
     >>>             help="The top trending Streamlit apps",
-    >>>             validate="^https://[a-z]+\\.streamlit\\.app$",
+    >>>             validate=r"^https://[a-z]+\\.streamlit\\.app$",
     >>>             max_chars=100,
-    >>>             display_text="https://(.*?)\\.streamlit\\.app"
+    >>>             display_text=r"https://(.*?)\\.streamlit\\.app"
     >>>         ),
     >>>         "creator": st.column_config.LinkColumn(
     >>>             "App Creator", display_text="Open profile"

streamlit/elements/lib/policies.py

@@ -19,7 +19,10 @@ from typing import TYPE_CHECKING, Any, Final, Sequence
 from streamlit import config, errors, logger, runtime
 from streamlit.elements.form_utils import is_in_form
 from streamlit.errors import StreamlitAPIException, StreamlitAPIWarning
-from streamlit.runtime.scriptrunner_utils.script_run_context import get_script_run_ctx
+from streamlit.runtime.scriptrunner_utils.script_run_context import (
+    get_script_run_ctx,
+    in_cached_function,
+)
 from streamlit.runtime.state import WidgetCallback, get_session_state
 
 if TYPE_CHECKING:
@@ -114,14 +117,12 @@ def check_cache_replay_rules() -> None:
     If there are other similar checks in the future, we could extend this
     function to check for those as well. And rename it to check_widget_usage_rules.
     """
-    if runtime.exists():
-        ctx = get_script_run_ctx()
-        if ctx and ctx.disallow_cached_widget_usage:
-            from streamlit import exception
-
-            # We use an exception here to show a proper stack trace
-            # that indicates to the user where the issue is.
-            exception(CachedWidgetWarning())
+    if in_cached_function.get():
+        from streamlit import exception
+
+        # We use an exception here to show a proper stack trace
+        # that indicates to the user where the issue is.
+        exception(CachedWidgetWarning())
 
 
 _fragment_writes_widget_to_outside_error = (

streamlit/elements/map.py

@@ -105,10 +105,7 @@ class MapMixin:
 
         Parameters
         ----------
-        data : pandas.DataFrame, pandas.Styler, pyarrow.Table, pyspark.sql.DataFrame,\
-            snowflake.snowpark.dataframe.DataFrame, snowflake.snowpark.table.Table,\
-            Iterable, dict, or None
-
+        data : Anything supported by st.dataframe
             The data to be plotted.
 
         latitude : str or None
@@ -170,8 +167,8 @@ class MapMixin:
         >>>
         >>> df = pd.DataFrame(
         ...     np.random.randn(1000, 2) / [50, 50] + [37.76, -122.4],
-        ...     columns=['lat', 'lon'])
-        ...
+        ...     columns=["lat", "lon"],
+        ... )
         >>> st.map(df)
 
         .. output::
@@ -180,7 +177,7 @@ class MapMixin:
 
         You can also customize the size and color of the datapoints:
 
-        >>> st.map(df, size=20, color='#0044ff')
+        >>> st.map(df, size=20, color="#0044ff")
 
         And finally, you can choose different columns to use for the latitude
         and longitude components, as well as set size and color of each
@@ -190,18 +187,16 @@ class MapMixin:
         >>> import pandas as pd
         >>> import numpy as np
         >>>
-        >>> df = pd.DataFrame({
-        ...     "col1": np.random.randn(1000) / 50 + 37.76,
-        ...     "col2": np.random.randn(1000) / 50 + -122.4,
-        ...     "col3": np.random.randn(1000) * 100,
-        ...     "col4": np.random.rand(1000, 4).tolist(),
-        ... })
+        >>> df = pd.DataFrame(
+        ...     {
+        ...         "col1": np.random.randn(1000) / 50 + 37.76,
+        ...         "col2": np.random.randn(1000) / 50 + -122.4,
+        ...         "col3": np.random.randn(1000) * 100,
+        ...         "col4": np.random.rand(1000, 4).tolist(),
+        ...     }
+        ... )
         >>>
-        >>> st.map(df,
-        ...     latitude='col1',
-        ...     longitude='col2',
-        ...     size='col3',
-        ...     color='col4')
+        >>> st.map(df, latitude="col1", longitude="col2", size="col3", color="col4")
 
         .. output::
            https://doc-map-color.streamlit.app/

streamlit/elements/vega_charts.py

@@ -122,7 +122,7 @@ class VegaLiteState(TypedDict, total=False):
     --------
     The following two examples have equivalent definitions. Each one has a
     point and interval selection parameter include in the chart definition.
-    The point seleciton parameter is named ``"point_selection"``. The interval
+    The point selection parameter is named ``"point_selection"``. The interval
     or box selection parameter is named ``"interval_selection"``.
 
     The follow example uses ``st.altair_chart``:
@@ -574,9 +574,7 @@ class VegaChartsMixin:
 
         Parameters
         ----------
-        data : pandas.DataFrame, pandas.Styler, pyarrow.Table, numpy.ndarray, \
-            pyspark.sql.DataFrame, snowflake.snowpark.dataframe.DataFrame, \
-            snowflake.snowpark.table.Table, Iterable, dict or None
+        data : Anything supported by st.dataframe
             Data to be plotted.
 
         x : str or None
@@ -773,9 +771,7 @@ class VegaChartsMixin:
 
         Parameters
         ----------
-        data : pandas.DataFrame, pandas.Styler, pyarrow.Table, numpy.ndarray, \
-            pyspark.sql.DataFrame, snowflake.snowpark.dataframe.DataFrame, \
-            snowflake.snowpark.table.Table, Iterable, or dict
+        data : Anything supported by st.dataframe
             Data to be plotted.
 
         x : str or None
@@ -1012,9 +1008,7 @@ class VegaChartsMixin:
 
         Parameters
         ----------
-        data : pandas.DataFrame, pandas.Styler, pyarrow.Table, numpy.ndarray, \
-            pyspark.sql.DataFrame, snowflake.snowpark.dataframe.DataFrame, \
-            snowflake.snowpark.table.Table, Iterable, or dict
+        data : Anything supported by st.dataframe
             Data to be plotted.
 
         x : str or None
@@ -1278,9 +1272,7 @@ class VegaChartsMixin:
 
         Parameters
         ----------
-        data : pandas.DataFrame, pandas.Styler, pyarrow.Table, numpy.ndarray, \
-            pyspark.sql.DataFrame, snowflake.snowpark.dataframe.DataFrame, \
-            snowflake.snowpark.table.Table, Iterable, dict or None
+        data : Anything supported by st.dataframe
             Data to be plotted.
 
         x : str or None
@@ -1661,7 +1653,7 @@ class VegaChartsMixin:
 
         Parameters
         ----------
-        data : pandas.DataFrame, pandas.Styler, pyarrow.Table, numpy.ndarray, Iterable, dict, or None
+        data : Anything supported by st.dataframe
             Either the data to be plotted or a Vega-Lite spec containing the
             data (which more closely follows the Vega-Lite API).
 

streamlit/elements/widgets/button_group.py

@@ -264,7 +264,7 @@ class ButtonGroupMixin:
 
         .. output ::
             https://doc-feedback-stars.streamlit.app/
-            height: 350px
+            height: 200px
 
         Display a feedback widget with thumbs, and show the selected sentiment:
 
@@ -277,7 +277,7 @@ class ButtonGroupMixin:
 
         .. output ::
             https://doc-feedback-thumbs.streamlit.app/
-            height: 350px
+            height: 200px
 
         """
 

streamlit/elements/widgets/data_editor.py

@@ -599,18 +599,21 @@ class DataEditorMixin:
 
         Parameters
         ----------
-        data : pandas.DataFrame, pandas.Series, pandas.Styler, pandas.Index, pyarrow.Table, numpy.ndarray, pyspark.sql.DataFrame, snowflake.snowpark.DataFrame, list, set, tuple, dict, or None
+        data : Anything supported by st.dataframe
             The data to edit in the data editor.
 
             .. note::
                 - Styles from ``pandas.Styler`` will only be applied to non-editable columns.
                 - Mixing data types within a column can make the column uneditable.
                 - Additionally, the following data types are not yet supported for editing:
-                  complex, list, tuple, bytes, bytearray, memoryview, dict, set, frozenset,
-                  fractions.Fraction, pandas.Interval, and pandas.Period.
-                - To prevent overflow in JavaScript, columns containing datetime.timedelta
-                  and pandas.Timedelta values will default to uneditable but this can be
-                  changed through column configuration.
+                  ``complex``, ``list``, ``tuple``, ``bytes``, ``bytearray``,
+                  ``memoryview``, ``dict``, ``set``, ``frozenset``,
+                  ``fractions.Fraction``, ``pandas.Interval``, and
+                  ``pandas.Period``.
+                - To prevent overflow in JavaScript, columns containing
+                  ``datetime.timedelta`` and ``pandas.Timedelta`` values will
+                  default to uneditable, but this can be changed through column
+                  configuration.
 
         width : int or None
             Desired width of the data editor expressed in pixels. If ``width``

streamlit/elements/widgets/multiselect.py

@@ -156,10 +156,10 @@ class MultiSelectMixin:
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
 
         options : Iterable
-            Labels for the select options in an Iterable. For example, this can
-            be a list, numpy.ndarray, pandas.Series, pandas.DataFrame, or
-            pandas.Index. For pandas.DataFrame, the first column is used.
-            Each label will be cast to str internally by default.
+            Labels for the select options in an ``Iterable``. This can be a
+            ``list``, ``set``, or anything supported by ``st.dataframe``. If
+            ``options`` is dataframe-like, the first column will be used. Each
+            label will be cast to ``str`` internally by default.
 
         default: Iterable of V, V, or None
             List of default values. Can also be a single value.

streamlit/elements/widgets/radio.py

@@ -16,7 +16,7 @@ from __future__ import annotations
 
 from dataclasses import dataclass
 from textwrap import dedent
-from typing import TYPE_CHECKING, Any, Callable, Generic, Sequence, cast
+from typing import TYPE_CHECKING, Any, Callable, Generic, Sequence, cast, overload
 
 from streamlit.dataframe_util import OptionSequence, convert_anything_to_list
 from streamlit.elements.form_utils import current_form_id
@@ -81,6 +81,44 @@ class RadioSerde(Generic[T]):
 
 
 class RadioMixin:
+    @overload
+    def radio(
+        self,
+        label: str,
+        options: OptionSequence[T],
+        index: int = 0,
+        format_func: Callable[[Any], Any] = str,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        *,  # keyword-only args:
+        disabled: bool = False,
+        horizontal: bool = False,
+        captions: Sequence[str] | None = None,
+        label_visibility: LabelVisibility = "visible",
+    ) -> T: ...
+
+    @overload
+    def radio(
+        self,
+        label: str,
+        options: OptionSequence[T],
+        index: None,
+        format_func: Callable[[Any], Any] = str,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        *,  # keyword-only args:
+        disabled: bool = False,
+        horizontal: bool = False,
+        captions: Sequence[str] | None = None,
+        label_visibility: LabelVisibility = "visible",
+    ) -> T | None: ...
+
     @gather_metrics("radio")
     def radio(
         self,
@@ -125,9 +163,10 @@ class RadioMixin:
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
 
         options : Iterable
-            Labels for the select options in an Iterable. For example, this can
-            be a list, numpy.ndarray, pandas.Series, pandas.DataFrame, or
-            pandas.Index. For pandas.DataFrame, the first column is used.
+            Labels for the select options in an ``Iterable``. This can be a
+            ``list``, ``set``, or anything supported by ``st.dataframe``. If
+            ``options`` is dataframe-like, the first column will be used. Each
+            label will be cast to ``str`` internally by default.
 
             Labels can include markdown as described in the ``label`` parameter
             and will be cast to str internally by default.

streamlit/elements/widgets/select_slider.py

@@ -16,7 +16,16 @@ from __future__ import annotations
 
 from dataclasses import dataclass
 from textwrap import dedent
-from typing import TYPE_CHECKING, Any, Callable, Generic, Sequence, Tuple, cast
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Generic,
+    Sequence,
+    Tuple,
+    cast,
+    overload,
+)
 
 from typing_extensions import TypeGuard
 
@@ -49,10 +58,7 @@ from streamlit.runtime.state.common import (
     compute_widget_id,
     save_for_app_testing,
 )
-from streamlit.type_util import (
-    T,
-    check_python_comparable,
-)
+from streamlit.type_util import T, check_python_comparable
 from streamlit.util import index_
 
 if TYPE_CHECKING:
@@ -102,12 +108,58 @@ class SelectSliderSerde(Generic[T]):
 
 
 class SelectSliderMixin:
+    @overload
+    def select_slider(  # type: ignore[overload-overlap]
+        self,
+        label: str,
+        options: OptionSequence[T],
+        value: tuple[T, T] | list[T],
+        format_func: Callable[[Any], Any] = str,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        *,  # keyword-only arguments:
+        disabled: bool = False,
+        label_visibility: LabelVisibility = "visible",
+    ) -> tuple[T, T]: ...
+
+    # The overload-overlap error given by mypy here stems from
+    # the fact that
+    #
+    #   opt:List[object] = [1, 2, "3"]
+    #   select_slider("foo", options=opt, value=[1, 2])
+    #
+    # matches both overloads; "opt" matches
+    # OptionsSequence[T] in each case, binding T to object.
+    # However, the list[int] type of "value" can be interpreted
+    # as subtype of object, or as a subtype of List[object],
+    # meaning it matches both signatures.
+
+    @overload
+    def select_slider(
+        self,
+        label: str,
+        options: OptionSequence[T] = (),
+        value: T | None = None,
+        format_func: Callable[[Any], Any] = str,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        *,  # keyword-only arguments:
+        disabled: bool = False,
+        label_visibility: LabelVisibility = "visible",
+    ) -> T: ...
+
     @gather_metrics("select_slider")
     def select_slider(
         self,
         label: str,
         options: OptionSequence[T] = (),
-        value: object = None,
+        value: T | Sequence[T] | None = None,
         format_func: Callable[[Any], Any] = str,
         key: Key | None = None,
         help: str | None = None,
@@ -153,10 +205,10 @@ class SelectSliderMixin:
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
 
         options : Iterable
-            Labels for the select options in an Iterable. For example, this can
-            be a list, numpy.ndarray, pandas.Series, pandas.DataFrame, or
-            pandas.Index. For pandas.DataFrame, the first column is used.
-            Each label will be cast to str internally by default.
+            Labels for the select options in an ``Iterable``. This can be a
+            ``list``, ``set``, or anything supported by ``st.dataframe``. If
+            ``options`` is dataframe-like, the first column will be used. Each
+            label will be cast to ``str`` internally by default.
 
         value : a supported type or a tuple/list of supported types or None
             The value of the slider when it first renders. If a tuple/list
@@ -266,7 +318,7 @@ class SelectSliderMixin:
         self,
         label: str,
         options: OptionSequence[T] = (),
-        value: object = None,
+        value: T | Sequence[T] | None = None,
         format_func: Callable[[Any], Any] = str,
         key: Key | None = None,
         help: str | None = None,

streamlit/elements/widgets/selectbox.py

@@ -153,10 +153,10 @@ class SelectboxMixin:
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
 
         options : Iterable
-            Labels for the select options in an Iterable. For example, this can
-            be a list, numpy.ndarray, pandas.Series, pandas.DataFrame, or
-            pandas.Index. For pandas.DataFrame, the first column is used.
-            Each label will be cast to str internally by default.
+            Labels for the select options in an ``Iterable``. This can be a
+            ``list``, ``set``, or anything supported by ``st.dataframe``. If
+            ``options`` is dataframe-like, the first column will be used. Each
+            label will be cast to ``str`` internally by default.
 
         index : int
             The index of the preselected option on first render. If ``None``,

streamlit/elements/write.py

@@ -259,7 +259,7 @@ class WriteMixin:
             - write(string)         : Prints the formatted Markdown string, with
                 support for LaTeX expression, emoji shortcodes, and colored text.
                 See docs for st.markdown for more.
-            - write(dataframe)      : Displays any dataframe-like object in a table.
+            - write(dataframe)      : Displays any dataframe-like object in an interactive table.
             - write(dict)           : Displays dict-like in an interactive viewer.
             - write(list)           : Displays list-like in an interactive viewer.
             - write(error)          : Prints an exception specially.