streamlit-nightly 1.41.2.dev20250201__py2.py3-none-any.whl → 1.42.1.dev20250204__py2.py3-none-any.whl

streamlit/elements/widgets/select_slider.py

@@ -21,8 +21,6 @@ from typing import (
     Any,
     Callable,
     Generic,
-    Sequence,
-    Tuple,
     cast,
     overload,
 )
@@ -64,6 +62,8 @@ from streamlit.runtime.state.common import (
 from streamlit.type_util import T, check_python_comparable
 
 if TYPE_CHECKING:
+    from collections.abc import Sequence
+
     from streamlit.delta_generator import DeltaGenerator
 
 
@@ -91,7 +91,7 @@ class SelectSliderSerde(Generic[T]):
 
         # The widget always returns floats, so convert to ints before indexing
         return_value: tuple[T, T] = cast(
-            Tuple[T, T],
+            tuple[T, T],
             tuple(self.options[int(x)] for x in ui_value),
         )
 
@@ -230,10 +230,14 @@ class SelectSliderMixin:
             If this is omitted, a key will be generated for the widget
             based on its content. No two widgets may have the same key.
 
-        help : str
-            An optional tooltip that gets displayed next to the widget label.
-            Streamlit only displays the tooltip when
-            ``label_visibility="visible"``.
+        help : str or None
+            A tooltip that gets displayed next to the widget label. Streamlit
+            only displays the tooltip when ``label_visibility="visible"``. If
+            this is ``None`` (default), no tooltip is displayed.
+
+            The tooltip can optionally contain GitHub-flavored Markdown,
+            including the Markdown directives described in the ``body``
+            parameter of ``st.markdown``.
 
         on_change : callable
             An optional callback invoked when this select_slider's value changes.
@@ -412,7 +416,7 @@ class SelectSliderMixin:
         )
         if isinstance(widget_state.value, tuple):
             widget_state = maybe_coerce_enum_sequence(
-                cast(RegisterWidgetResult[Tuple[T, T]], widget_state), options, opt
+                cast(RegisterWidgetResult[tuple[T, T]], widget_state), options, opt
             )
         else:
             widget_state = maybe_coerce_enum(widget_state, options, opt)

streamlit/elements/widgets/selectbox.py

@@ -15,7 +15,7 @@ from __future__ import annotations
 
 from dataclasses import dataclass
 from textwrap import dedent
-from typing import TYPE_CHECKING, Any, Callable, Generic, Sequence, cast, overload
+from typing import TYPE_CHECKING, Any, Callable, Generic, cast, overload
 
 from streamlit.dataframe_util import OptionSequence, convert_anything_to_list
 from streamlit.elements.lib.form_utils import current_form_id
@@ -49,6 +49,8 @@ from streamlit.type_util import (
 )
 
 if TYPE_CHECKING:
+    from collections.abc import Sequence
+
     from streamlit.delta_generator import DeltaGenerator
 
 
@@ -175,10 +177,14 @@ class SelectboxMixin:
             If this is omitted, a key will be generated for the widget
             based on its content. No two widgets may have the same key.
 
-        help : str
-            An optional tooltip that gets displayed next to the widget label.
-            Streamlit only displays the tooltip when
-            ``label_visibility="visible"``.
+        help : str or None
+            A tooltip that gets displayed next to the widget label. Streamlit
+            only displays the tooltip when ``label_visibility="visible"``. If
+            this is ``None`` (default), no tooltip is displayed.
+
+            The tooltip can optionally contain GitHub-flavored Markdown,
+            including the Markdown directives described in the ``body``
+            parameter of ``st.markdown``.
 
         on_change : callable
             An optional callback invoked when this selectbox's value changes.

streamlit/elements/widgets/slider.py

@@ -14,6 +14,7 @@
 
 from __future__ import annotations
 
+from collections.abc import Sequence
 from dataclasses import dataclass
 from datetime import date, datetime, time, timedelta, timezone, tzinfo
 from numbers import Integral, Real
@@ -22,9 +23,6 @@ from typing import (
     TYPE_CHECKING,
     Any,
     Final,
-    List,
-    Sequence,
-    Tuple,
     TypeVar,
     Union,
     cast,
@@ -65,16 +63,16 @@ SliderNumericT = TypeVar("SliderNumericT", int, float)
 SliderDatelikeT = TypeVar("SliderDatelikeT", date, time, datetime)
 
 SliderNumericSpanT: TypeAlias = Union[
-    List[SliderNumericT],
-    Tuple[()],
-    Tuple[SliderNumericT],
-    Tuple[SliderNumericT, SliderNumericT],
+    list[SliderNumericT],
+    tuple[()],
+    tuple[SliderNumericT],
+    tuple[SliderNumericT, SliderNumericT],
 ]
 SliderDatelikeSpanT: TypeAlias = Union[
-    List[SliderDatelikeT],
-    Tuple[()],
-    Tuple[SliderDatelikeT],
-    Tuple[SliderDatelikeT, SliderDatelikeT],
+    list[SliderDatelikeT],
+    tuple[()],
+    tuple[SliderDatelikeT],
+    tuple[SliderDatelikeT, SliderDatelikeT],
 ]
 
 StepNumericT: TypeAlias = SliderNumericT
@@ -96,8 +94,8 @@ SliderValue: TypeAlias = Union[
 ]
 SliderReturnGeneric: TypeAlias = Union[
     SliderValueT,
-    Tuple[SliderValueT],
-    Tuple[SliderValueT, SliderValueT],
+    tuple[SliderValueT],
+    tuple[SliderValueT, SliderValueT],
 ]
 SliderReturn: TypeAlias = Union[
     SliderReturnGeneric[int],
@@ -426,10 +424,14 @@ class SliderMixin:
             If this is omitted, a key will be generated for the widget
             based on its content. No two widgets may have the same key.
 
-        help : str
-            An optional tooltip that gets displayed next to the widget label.
-            Streamlit only displays the tooltip when
-            ``label_visibility="visible"``.
+        help : str or None
+            A tooltip that gets displayed next to the widget label. Streamlit
+            only displays the tooltip when ``label_visibility="visible"``. If
+            this is ``None`` (default), no tooltip is displayed.
+
+            The tooltip can optionally contain GitHub-flavored Markdown,
+            including the Markdown directives described in the ``body``
+            parameter of ``st.markdown``.
 
         on_change : callable
             An optional callback invoked when this slider's value changes.

streamlit/elements/widgets/text_widgets.py

@@ -176,10 +176,14 @@ class TextWidgetsMixin:
             a regular text input), or "password" (for a text input that
             masks the user's typed value). Defaults to "default".
 
-        help : str
-            An optional tooltip that gets displayed next to the widget label.
-            Streamlit only displays the tooltip when
-            ``label_visibility="visible"``.
+        help : str or None
+            A tooltip that gets displayed next to the widget label. Streamlit
+            only displays the tooltip when ``label_visibility="visible"``. If
+            this is ``None`` (default), no tooltip is displayed.
+
+            The tooltip can optionally contain GitHub-flavored Markdown,
+            including the Markdown directives described in the ``body``
+            parameter of ``st.markdown``.
 
         autocomplete : str
             An optional value that will be passed to the <input> element's
@@ -450,10 +454,14 @@ class TextWidgetsMixin:
             If this is omitted, a key will be generated for the widget
             based on its content. No two widgets may have the same key.
 
-        help : str
-            An optional tooltip that gets displayed next to the widget label.
-            Streamlit only displays the tooltip when
-            ``label_visibility="visible"``.
+        help : str or None
+            A tooltip that gets displayed next to the widget label. Streamlit
+            only displays the tooltip when ``label_visibility="visible"``. If
+            this is ``None`` (default), no tooltip is displayed.
+
+            The tooltip can optionally contain GitHub-flavored Markdown,
+            including the Markdown directives described in the ``body``
+            parameter of ``st.markdown``.
 
         on_change : callable
             An optional callback invoked when this text_area's value changes.

streamlit/elements/widgets/time_widgets.py

@@ -14,6 +14,7 @@
 from __future__ import annotations
 
 import re
+from collections.abc import Sequence
 from dataclasses import dataclass
 from datetime import date, datetime, time, timedelta
 from textwrap import dedent
@@ -21,10 +22,7 @@ from typing import (
     TYPE_CHECKING,
     Any,
     Final,
-    List,
     Literal,
-    Sequence,
-    Tuple,
     Union,
     cast,
     overload,
@@ -72,9 +70,9 @@ DateValue: TypeAlias = Union[NullableScalarDateValue, Sequence[NullableScalarDat
 
 # The return value of st.date_input.
 DateWidgetRangeReturn: TypeAlias = Union[
-    Tuple[()],
-    Tuple[date],
-    Tuple[date, date],
+    tuple[()],
+    tuple[date],
+    tuple[date, date],
 ]
 DateWidgetReturn: TypeAlias = Union[date, DateWidgetRangeReturn, None]
 
@@ -229,7 +227,7 @@ class _DateInputValues:
         )
 
         if value == "today":
-            v = cast(List[date], parsed_value)[0]
+            v = cast(list[date], parsed_value)[0]
             if v < parsed_min:
                 parsed_value = [parsed_min]
             if v > parsed_max:
@@ -406,10 +404,14 @@ class TimeWidgetsMixin:
             If this is omitted, a key will be generated for the widget
             based on its content. No two widgets may have the same key.
 
-        help : str
-            An optional tooltip that gets displayed next to the widget label.
-            Streamlit only displays the tooltip when
-            ``label_visibility="visible"``.
+        help : str or None
+            A tooltip that gets displayed next to the widget label. Streamlit
+            only displays the tooltip when ``label_visibility="visible"``. If
+            this is ``None`` (default), no tooltip is displayed.
+
+            The tooltip can optionally contain GitHub-flavored Markdown,
+            including the Markdown directives described in the ``body``
+            parameter of ``st.markdown``.
 
         on_change : callable
             An optional callback invoked when this time_input's value changes.
@@ -716,10 +718,14 @@ class TimeWidgetsMixin:
             If this is omitted, a key will be generated for the widget
             based on its content. No two widgets may have the same key.
 
-        help : str
-            An optional tooltip that gets displayed next to the widget label.
-            Streamlit only displays the tooltip when
-            ``label_visibility="visible"``.
+        help : str or None
+            A tooltip that gets displayed next to the widget label. Streamlit
+            only displays the tooltip when ``label_visibility="visible"``. If
+            this is ``None`` (default), no tooltip is displayed.
+
+            The tooltip can optionally contain GitHub-flavored Markdown,
+            including the Markdown directives described in the ``body``
+            parameter of ``st.markdown``.
 
         on_change : callable
             An optional callback invoked when this date_input's value changes.

streamlit/elements/write.py

@@ -18,17 +18,20 @@ import dataclasses
 import inspect
 import types
 from collections import ChainMap, UserDict, UserList
-from collections.abc import ItemsView, KeysView, ValuesView
+from collections.abc import (
+    AsyncGenerator,
+    Generator,
+    ItemsView,
+    Iterable,
+    KeysView,
+    ValuesView,
+)
 from io import StringIO
 from typing import (
     TYPE_CHECKING,
     Any,
-    AsyncGenerator,
     Callable,
     Final,
-    Generator,
-    Iterable,
-    List,
     cast,
 )
 
@@ -58,7 +61,7 @@ _LOGGER: Final = get_logger(__name__)
 _TEXT_CURSOR: Final = " ▏"
 
 
-class StreamingOutput(List[Any]):
+class StreamingOutput(list[Any]):
     pass
 
 
@@ -251,48 +254,59 @@ class WriteMixin:
 
     @gather_metrics("write")
     def write(self, *args: Any, unsafe_allow_html: bool = False, **kwargs) -> None:
-        """Write arguments to the app.
+        """Displays arguments in the app.
 
         This is the Swiss Army knife of Streamlit commands: it does different
-        things depending on what you throw at it. Unlike other Streamlit commands,
-        write() has some unique properties:
+        things depending on what you throw at it. Unlike other Streamlit
+        commands, ``st.write()`` has some unique properties:
 
-        1. You can pass in multiple arguments, all of which will be written.
-        2. Its behavior depends on the input types as follows.
-        3. It returns None, so its "slot" in the App cannot be reused.
+        - You can pass in multiple arguments, all of which will be displayed.
+        - Its behavior depends on the input type(s).
 
         Parameters
         ----------
         *args : any
-            One or many objects to print to the App.
-
-            Arguments are handled as follows:
-
-            - 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 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.
-            - write(func)           : Displays information about a function.
-            - write(module)         : Displays information about a module.
-            - write(class)          : Displays information about a class.
-            - write(DeltaGenerator) : Displays information about a DeltaGenerator.
-            - write(mpl_fig)        : Displays a Matplotlib figure.
-            - write(generator)      : Streams the output of a generator.
-            - write(openai.Stream)  : Streams the output of an OpenAI stream.
-            - write(altair)         : Displays an Altair chart.
-            - write(PIL.Image)      : Displays an image.
-            - write(keras)          : Displays a Keras model.
-            - write(graphviz)       : Displays a Graphviz graph.
-            - write(plotly_fig)     : Displays a Plotly figure.
-            - write(bokeh_fig)      : Displays a Bokeh figure.
-            - write(sympy_expr)     : Prints SymPy expression using LaTeX.
-            - write(htmlable)       : Prints _repr_html_() for the object if available.
-            - write(db_cursor)      : Displays DB API 2.0 cursor results in a table.
-            - write(obj)            : Prints str(obj) if otherwise unknown.
-
+            One or many objects to display in the app.
+
+            .. list-table:: Each type of argument is handled as follows:
+                :header-rows: 1
+
+                * - Type
+                  - Handling
+                * - ``str``
+                  - Uses ``st.markdown()``.
+                * - dataframe-like, ``dict``, or ``list``
+                  - Uses ``st.dataframe()``.
+                * - ``Exception``
+                  - Uses ``st.exception()``.
+                * - function, module, or class
+                  - Uses ``st.help()``.
+                * - ``DeltaGenerator``
+                  - Uses ``st.help()``.
+                * - Altair chart
+                  - Uses ``st.altair_chart()``.
+                * - Bokeh figure
+                  - Uses ``st.bokeh_chart()``.
+                * - Graphviz graph
+                  - Uses ``st.graphviz_chart()``.
+                * - Keras model
+                  - Converts model and uses ``st.graphviz_chart()``.
+                * - Matplotlib figure
+                  - Uses ``st.pyplot()``.
+                * - Plotly figure
+                  - Uses ``st.plotly_chart()``.
+                * - ``PIL.Image``
+                  - Uses ``st.image()``.
+                * - generator or stream (like ``openai.Stream``)
+                  - Uses ``st.write_stream()``.
+                * - SymPy expression
+                  - Uses ``st.latex()``.
+                * - An object with ``._repr_html()``
+                  - Uses ``st.html()``.
+                * - Database cursor
+                  - Displays DB API 2.0 cursor results in a table.
+                * - Any
+                  - Displays ``str(arg)`` as inline code.
 
         unsafe_allow_html : bool
             Whether to render HTML within ``*args``. This only applies to
@@ -316,9 +330,12 @@ class WriteMixin:
             Use other, more specific Streamlit commands to pass additional
             keyword arguments.
 
-
-        Example
+        Returns
         -------
+        None
+
+        Examples
+        --------
 
         Its basic use case is to draw Markdown-formatted text, whenever the
         input is a string:

streamlit/errors.py

@@ -154,8 +154,7 @@ class StreamlitModuleNotFoundError(StreamlitAPIWarning):
 
     def __init__(self, module_name, *args):
         message = (
-            f'This Streamlit command requires module "{module_name}" '
-            "to be installed."
+            f'This Streamlit command requires module "{module_name}" to be installed.'
         )
         super().__init__(message, *args)
 

streamlit/external/langchain/streamlit_callback_handler.py

@@ -246,9 +246,9 @@ class LLMThought:
     def complete(self, final_label: str | None = None) -> None:
         """Finish the thought."""
         if final_label is None and self._state == LLMThoughtState.RUNNING_TOOL:
-            assert (
-                self._last_tool is not None
-            ), "_last_tool should never be null when _state == RUNNING_TOOL"
+            assert self._last_tool is not None, (
+                "_last_tool should never be null when _state == RUNNING_TOOL"
+            )
             final_label = self._labeler.get_tool_label(
                 self._last_tool, is_complete=True
             )

streamlit/hello/animation_demo.py

@@ -74,7 +74,7 @@ st.title("Animation demo")
 st.write(
     """
     This app shows how you can use Streamlit to build cool animations.
-    It displays an animated fractal based on the the Julia Set. Use the slider
+    It displays an animated fractal based on the Julia Set. Use the slider
     to tune different parameters.
     """
 )