streamlit-nightly 1.41.2.dev20241227__py2.py3-none-any.whl → 1.41.2.dev20250124__py2.py3-none-any.whl

streamlit/elements/markdown.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -19,7 +19,7 @@ from typing import TYPE_CHECKING, Final, cast
 from streamlit.proto.Markdown_pb2 import Markdown as MarkdownProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.string_util import clean_text
-from streamlit.type_util import SupportsStr, is_sympy_expession
+from streamlit.type_util import SupportsStr, is_sympy_expression
 
 if TYPE_CHECKING:
     import sympy
@@ -261,7 +261,7 @@ class MarkdownMixin:
         ...     ''')
 
         """
-        if is_sympy_expession(body):
+        if is_sympy_expression(body):
             import sympy
 
             body = sympy.latex(body)

streamlit/elements/media.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/metric.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/plotly_chart.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/progress.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/pyplot.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/snow.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/spinner.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -23,21 +23,27 @@ from streamlit.runtime.scriptrunner import add_script_run_ctx
 
 
 @contextlib.contextmanager
-def spinner(text: str = "In progress...", *, _cache: bool = False) -> Iterator[None]:
-    """Temporarily displays a message while executing a block of code.
+def spinner(
+    text: str = "In progress...",
+    *,
+    show_time: bool = False,
+    _cache: bool = False,
+) -> Iterator[None]:
+    """Display a loading spinner while executing a block of code.
 
     Parameters
     ----------
     text : str
-        A message to display while executing that block
+        The text to display next to the spinner. Defaults to "In progress...".
+    show_time : bool
+        Whether to show the elapsed time next to the spinner text. Defaults to False.
 
     Example
     -------
-
-    >>> import time
     >>> import streamlit as st
+    >>> import time
     >>>
-    >>> with st.spinner('Wait for it...'):
+    >>> with st.spinner("Wait for it...", show_time=True):
     >>>     time.sleep(5)
     >>> st.success("Done!")
 
@@ -61,6 +67,7 @@ def spinner(text: str = "In progress...", *, _cache: bool = False) -> Iterator[N
                     spinner_proto = SpinnerProto()
                     spinner_proto.text = clean_text(text)
                     spinner_proto.cache = _cache
+                    spinner_proto.show_time = show_time
                     message._enqueue("spinner", spinner_proto)
 
         add_script_run_ctx(threading.Timer(DELAY_SECS, set_message)).start()

streamlit/elements/text.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/toast.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/vega_charts.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -29,6 +29,7 @@ from typing import (
     Literal,
     Sequence,
     TypedDict,
+    Union,
     cast,
     overload,
 )
@@ -95,6 +96,15 @@ _CHANNELS: Final = {
 }
 
 VegaLiteSpec: TypeAlias = "dict[str, Any]"
+AltairChart: TypeAlias = Union[
+    "alt.Chart",
+    "alt.ConcatChart",
+    "alt.FacetChart",
+    "alt.HConcatChart",
+    "alt.LayerChart",
+    "alt.RepeatChart",
+    "alt.VConcatChart",
+]
 
 
 class VegaLiteState(TypedDict, total=False):
@@ -323,7 +333,7 @@ def _marshall_chart_data(
 
 
 def _convert_altair_to_vega_lite_spec(
-    altair_chart: alt.Chart | alt.LayerChart,
+    altair_chart: AltairChart,
 ) -> VegaLiteSpec:
     """Convert an Altair chart object to a Vega-Lite chart spec."""
     import altair as alt
@@ -1462,10 +1472,11 @@ class VegaChartsMixin:
             ),
         )
 
+    # When on_select=Ignore, return DeltaGenerator.
     @overload
     def altair_chart(
         self,
-        altair_chart: alt.Chart,
+        altair_chart: AltairChart,
         *,
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
@@ -1474,10 +1485,11 @@ class VegaChartsMixin:
         selection_mode: str | Iterable[str] | None = None,
     ) -> DeltaGenerator: ...
 
+    # When on_select=rerun, return VegaLiteState.
     @overload
     def altair_chart(
         self,
-        altair_chart: alt.Chart,
+        altair_chart: AltairChart,
         *,
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
@@ -1489,7 +1501,7 @@ class VegaChartsMixin:
     @gather_metrics("altair_chart")
     def altair_chart(
         self,
-        altair_chart: alt.Chart,
+        altair_chart: AltairChart,
         *,
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
@@ -1616,6 +1628,7 @@ class VegaChartsMixin:
             selection_mode=selection_mode,
         )
 
+    # When on_select=Ignore, return DeltaGenerator.
     @overload
     def vega_lite_chart(
         self,
@@ -1630,6 +1643,7 @@ class VegaChartsMixin:
         **kwargs: Any,
     ) -> DeltaGenerator: ...
 
+    # When on_select=rerun, return VegaLiteState.
     @overload
     def vega_lite_chart(
         self,
@@ -1795,7 +1809,7 @@ class VegaChartsMixin:
 
     def _altair_chart(
         self,
-        altair_chart: alt.Chart | alt.LayerChart,
+        altair_chart: AltairChart,
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
         key: Key | None = None,

streamlit/elements/widgets/__init__.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/audio_input.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/button.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -804,6 +804,11 @@ class ButtonMixin:
         use_container_width: bool | None = None,
     ) -> DeltaGenerator:
         page_link_proto = PageLinkProto()
+
+        ctx = get_script_run_ctx()
+        if not ctx:
+            return self.dg._enqueue("page_link", page_link_proto)
+
         page_link_proto.disabled = disabled
 
         if label is not None:
@@ -837,12 +842,10 @@ class ButtonMixin:
                     page_link_proto.external = True
                     return self.dg._enqueue("page_link", page_link_proto)
 
-            ctx = get_script_run_ctx()
             ctx_main_script = ""
             all_app_pages = {}
-            if ctx:
-                ctx_main_script = ctx.main_script_path
-                all_app_pages = ctx.pages_manager.get_pages()
+            ctx_main_script = ctx.main_script_path
+            all_app_pages = ctx.pages_manager.get_pages()
 
             main_script_directory = get_main_script_directory(ctx_main_script)
             requested_page = os.path.realpath(
@@ -862,9 +865,7 @@ class ButtonMixin:
 
             if page_link_proto.page_script_hash == "":
                 is_mpa_v2 = (
-                    ctx is not None
-                    and ctx.pages_manager is not None
-                    and ctx.pages_manager.mpa_version == 2
+                    ctx.pages_manager is not None and ctx.pages_manager.mpa_version == 2
                 )
 
                 raise StreamlitPageNotFoundError(

streamlit/elements/widgets/button_group.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -52,7 +52,7 @@ from streamlit.proto.ButtonGroup_pb2 import ButtonGroup as ButtonGroupProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner_utils.script_run_context import get_script_run_ctx
 from streamlit.runtime.state import register_widget
-from streamlit.string_util import validate_material_icon
+from streamlit.string_util import is_emoji, validate_material_icon
 from streamlit.type_util import T
 
 if TYPE_CHECKING:
@@ -822,10 +822,12 @@ class ButtonGroupMixin:
             if len(transformed_parts) > 0:
                 maybe_icon = transformed_parts[0].strip()
                 try:
-                    # we only want to extract material icons because we treat them
-                    # differently than emojis visually
                     if maybe_icon.startswith(":material"):
                         icon = validate_material_icon(maybe_icon)
+                    elif is_emoji(maybe_icon):
+                        icon = maybe_icon
+
+                    if icon:
                         # reassamble the option string without the icon - also
                         # works if len(transformed_parts) == 1
                         transformed = " ".join(transformed_parts[1:])

streamlit/elements/widgets/camera_input.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/chat.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/checkbox.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/color_picker.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/data_editor.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -237,7 +237,10 @@ def _parse_value(
 
     except (ValueError, pd.errors.ParserError) as ex:
         _LOGGER.warning(
-            "Failed to parse value %s as %s. Exception: %s", value, column_data_kind, ex
+            "Failed to parse value %s as %s.",
+            value,
+            column_data_kind,
+            exc_info=ex,
         )
         return None
     return value
@@ -408,9 +411,7 @@ def _is_supported_index(df_index: pd.Index) -> bool:
             pd.RangeIndex,
             pd.Index,
             pd.DatetimeIndex,
-            # Categorical index doesn't work since arrow
-            # does serialize the options:
-            # pd.CategoricalIndex,
+            pd.CategoricalIndex,
             # Interval type isn't editable currently:
             # pd.IntervalIndex,
             # Period type isn't editable currently:

streamlit/elements/widgets/file_uploader.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/multiselect.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/number_input.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/radio.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/select_slider.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/selectbox.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/slider.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/text_widgets.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

streamlit/elements/widgets/time_widgets.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -71,9 +71,13 @@ NullableScalarDateValue: TypeAlias = Union[date, datetime, str, Literal["today"]
 DateValue: TypeAlias = Union[NullableScalarDateValue, Sequence[NullableScalarDateValue]]
 
 # The return value of st.date_input.
-DateWidgetReturn: TypeAlias = Union[
-    date, Tuple[()], Tuple[date], Tuple[date, date], None
+DateWidgetRangeReturn: TypeAlias = Union[
+    Tuple[()],
+    Tuple[date],
+    Tuple[date, date],
 ]
+DateWidgetReturn: TypeAlias = Union[date, DateWidgetRangeReturn, None]
+
 
 DEFAULT_STEP_MINUTES: Final = 15
 ALLOWED_DATE_FORMATS: Final = re.compile(
@@ -567,6 +571,62 @@ class TimeWidgetsMixin:
         self.dg._enqueue("time_input", time_input_proto)
         return widget_state.value
 
+    @overload
+    def date_input(
+        self,
+        label: str,
+        value: date | datetime | str | Literal["today"] = "today",
+        min_value: NullableScalarDateValue = None,
+        max_value: NullableScalarDateValue = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        *,  # keyword-only arguments:
+        format: str = "YYYY/MM/DD",
+        disabled: bool = False,
+        label_visibility: LabelVisibility = "visible",
+    ) -> date: ...
+
+    @overload
+    def date_input(
+        self,
+        label: str,
+        value: None,
+        min_value: NullableScalarDateValue = None,
+        max_value: NullableScalarDateValue = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        *,  # keyword-only arguments:
+        format: str = "YYYY/MM/DD",
+        disabled: bool = False,
+        label_visibility: LabelVisibility = "visible",
+    ) -> date | None: ...
+
+    @overload
+    def date_input(
+        self,
+        label: str,
+        value: tuple[NullableScalarDateValue]
+        | tuple[NullableScalarDateValue, NullableScalarDateValue]
+        | list[NullableScalarDateValue],
+        min_value: NullableScalarDateValue = None,
+        max_value: NullableScalarDateValue = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        *,  # keyword-only arguments:
+        format: str = "YYYY/MM/DD",
+        disabled: bool = False,
+        label_visibility: LabelVisibility = "visible",
+    ) -> DateWidgetRangeReturn: ...
+
     @gather_metrics("date_input")
     def date_input(
         self,

streamlit/elements/write.py

@@ -1,4 +1,4 @@
-# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -452,7 +452,7 @@ class WriteMixin:
             elif type_util.is_graphviz_chart(arg):
                 flush_buffer()
                 self.dg.graphviz_chart(arg)
-            elif type_util.is_sympy_expession(arg):
+            elif type_util.is_sympy_expression(arg):
                 flush_buffer()
                 self.dg.latex(arg)
             elif type_util.is_pillow_image(arg):