streamlit-nightly 1.46.1.dev20250625__py3-none-any.whl → 1.46.2.dev20250627__py3-none-any.whl

streamlit/__init__.py

@@ -13,7 +13,7 @@
 # limitations under the License.
 
 # isort: skip_file
-# ruff: noqa: E402, PLC0414, A001
+# ruff: noqa: E402, A001
 
 """Streamlit.
 

streamlit/elements/dialog_decorator.py

@@ -134,7 +134,7 @@ def dialog_decorator(title: F, *, width: DialogWidth = "small") -> F: ...
 def dialog_decorator(
     title: F | str, *, width: DialogWidth = "small"
 ) -> F | Callable[[F], F]:
-    """Function decorator to create a modal dialog.
+    r"""Function decorator to create a modal dialog.
 
     A function decorated with ``@st.dialog`` becomes a dialog
     function. When you call a dialog function, Streamlit inserts a modal dialog
@@ -173,6 +173,23 @@ def dialog_decorator(
     ----------
     title : str
         The title to display at the top of the modal dialog. It cannot be empty.
+
+        The title can optionally contain GitHub-flavored Markdown of the
+        following types: Bold, Italics, Strikethroughs, Inline Code, Links,
+        and Images. Images display like icons, with a max height equal to
+        the font height.
+
+        Unsupported Markdown elements are unwrapped so only their children
+        (text contents) render. Display unsupported elements as literal
+        characters by backslash-escaping them. E.g.,
+        ``"1\. Not an ordered list"``.
+
+        See the ``body`` parameter of |st.markdown|_ for additional,
+        supported Markdown directives.
+
+        .. |st.markdown| replace:: ``st.markdown``
+        .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
+
     width : "small", "large"
         The width of the modal dialog. If ``width`` is ``"small`` (default), the
         modal dialog will be 500 pixels wide. If ``width`` is ``"large"``, the

streamlit/elements/lib/column_types.py

@@ -23,6 +23,7 @@ from typing import TYPE_CHECKING, Literal, TypedDict
 from typing_extensions import NotRequired, TypeAlias
 
 from streamlit.runtime.metrics_util import gather_metrics
+from streamlit.string_util import validate_material_icon
 
 if TYPE_CHECKING:
     from collections.abc import Iterable
@@ -38,6 +39,7 @@ NumberFormat: TypeAlias = Literal[
     "scientific",
     "engineering",
     "accounting",
+    "bytes",
 ]
 
 ColumnWidth: TypeAlias = Literal["small", "medium", "large"]
@@ -429,6 +431,7 @@ def NumberColumn(
         - ``"euro"``: Show the number as a euro amount (e.g. "€1,234.57").
         - ``"yen"``: Show the number as a yen amount (e.g. "¥1,235").
         - ``"accounting"``: Show the number in an accounting format (e.g. "1,234.00").
+        - ``"bytes"``: Show the number in a byte format (e.g. "1.2KB").
         - ``"compact"``: Show the number in a compact format (e.g. "1.2K").
         - ``"scientific"``: Show the number in scientific notation (e.g. "1.235E3").
         - ``"engineering"``: Show the number in engineering notation (e.g. "1.235E3").
@@ -711,6 +714,7 @@ def LinkColumn(
 
         - ``None`` (default) to display the URL itself.
         - A string that is displayed in every cell, e.g. ``"Open link"``.
+        - A material icon displayed in every cell, e.g. ``":material/open_in_new:"``
         - A JS-flavored regular expression (detected by usage of parentheses)
           to extract a part of the URL via a capture group. For example, use
           ``"https://(.*?)\.example\.com"`` to extract the display text
@@ -768,6 +772,8 @@ def LinkColumn(
         https://doc-link-column.streamlit.app/
         height: 300px
     """
+    if display_text and display_text.startswith(":material/"):
+        display_text = validate_material_icon(display_text)
 
     return ColumnConfig(
         label=label,
@@ -2005,6 +2011,7 @@ def ProgressColumn(
         - ``"euro"``: Show the number as a euro amount (e.g. "€1,234.57").
         - ``"yen"``: Show the number as a yen amount (e.g. "¥1,235").
         - ``"accounting"``: Show the number in an accounting format (e.g. "1,234.00").
+        - ``"bytes"``: Show the number in a byte format (e.g. "1.2KB").
         - ``"compact"``: Show the number in a compact format (e.g. "1.2K").
         - ``"scientific"``: Show the number in scientific notation (e.g. "1.235E3").
         - ``"engineering"``: Show the number in engineering notation (e.g. "1.235E3").

streamlit/runtime/caching/cache_data_api.py

@@ -24,13 +24,14 @@ from typing import (
     Callable,
     Final,
     Literal,
+    Protocol,
     TypeVar,
     Union,
     cast,
     overload,
 )
 
-from typing_extensions import TypeAlias
+from typing_extensions import ParamSpec, TypeAlias
 
 import streamlit as st
 from streamlit import runtime
@@ -318,7 +319,25 @@ def get_data_cache_stats_provider() -> CacheStatsProvider:
 
 # Type-annotate the decorator function.
 # (See https://mypy.readthedocs.io/en/stable/generics.html#decorator-factories)
-F = TypeVar("F", bound=Callable[..., Any])
+P = ParamSpec("P")
+T_co = TypeVar("T_co", covariant=True)
+
+
+class CachedFunc(Protocol[P, T_co]):
+    """Protocol for cached functions that preserve the original function's signature and add a clear method."""
+
+    def __call__(self, *args: P.args, **kwargs: P.kwargs) -> T_co: ...
+
+    @overload
+    def clear(self) -> None: ...
+
+    @overload
+    def clear(self, *args: P.args, **kwargs: P.kwargs) -> None: ...
+
+    # Currently we can't define the "all-optional" argument overload with `P.args` and `P.kwargs` in Python.
+    # So we use `Any` as a fallback.
+    @overload
+    def clear(self, *args: Any, **kwargs: Any) -> None: ...
 
 
 class CacheDataAPI:
@@ -343,7 +362,7 @@ class CacheDataAPI:
 
     # Bare decorator usage
     @overload
-    def __call__(self, func: F) -> F: ...
+    def __call__(self, func: Callable[P, T_co]) -> CachedFunc[P, T_co]: ...
 
     # Decorator with arguments
     @overload
@@ -356,11 +375,11 @@ class CacheDataAPI:
         persist: CachePersistType | bool = None,
         experimental_allow_widgets: bool = False,
         hash_funcs: HashFuncsDict | None = None,
-    ) -> Callable[[F], F]: ...
+    ) -> Callable[[Callable[P, T_co]], CachedFunc[P, T_co]]: ...
 
     def __call__(
         self,
-        func: F | None = None,
+        func: Callable[P, T_co] | None = None,
         *,
         ttl: float | timedelta | str | None = None,
         max_entries: int | None = None,
@@ -368,7 +387,7 @@ class CacheDataAPI:
         persist: CachePersistType | bool = None,
         experimental_allow_widgets: bool = False,
         hash_funcs: HashFuncsDict | None = None,
-    ) -> F | Callable[[F], F]:
+    ) -> CachedFunc[P, T_co] | Callable[[Callable[P, T_co]], CachedFunc[P, T_co]]:
         return self._decorator(
             func,
             ttl=ttl,
@@ -381,7 +400,7 @@ class CacheDataAPI:
 
     def _decorator(
         self,
-        func: F | None = None,
+        func: Callable[P, T_co] | None = None,
         *,
         ttl: float | timedelta | str | None,
         max_entries: int | None,
@@ -389,7 +408,7 @@ class CacheDataAPI:
         persist: CachePersistType | bool,
         experimental_allow_widgets: bool,
         hash_funcs: HashFuncsDict | None = None,
-    ) -> F | Callable[[F], F]:
+    ) -> CachedFunc[P, T_co] | Callable[[Callable[P, T_co]], CachedFunc[P, T_co]]:
         """Decorator to cache functions that return data (e.g. dataframe transforms, database queries, ML inference).
 
         Cached objects are stored in "pickled" form, which means that the return
@@ -567,9 +586,9 @@ class CacheDataAPI:
         if experimental_allow_widgets:
             show_widget_replay_deprecation("cache_data")
 
-        def wrapper(f: F) -> F:
+        def wrapper(f: Callable[P, T_co]) -> CachedFunc[P, T_co]:
             return cast(
-                "F",
+                "CachedFunc[P, T_co]",
                 make_cached_func_wrapper(
                     CachedDataFuncInfo(
                         func=f,  # type: ignore

streamlit/runtime/caching/cache_resource_api.py

@@ -18,10 +18,19 @@ from __future__ import annotations
 
 import math
 import threading
-from typing import TYPE_CHECKING, Any, Callable, Final, TypeVar, cast, overload
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Final,
+    Protocol,
+    TypeVar,
+    cast,
+    overload,
+)
 
 from cachetools import TTLCache
-from typing_extensions import TypeAlias
+from typing_extensions import ParamSpec, TypeAlias
 
 import streamlit as st
 from streamlit.logger import get_logger
@@ -184,6 +193,29 @@ class CachedResourceFuncInfo(CachedFuncInfo):
         )
 
 
+# Type-annotate the decorator function.
+# (See https://mypy.readthedocs.io/en/stable/generics.html#decorator-factories)
+P = ParamSpec("P")
+T_co = TypeVar("T_co", covariant=True)
+
+
+class CachedFunc(Protocol[P, T_co]):
+    """Protocol for cached functions that preserve the original function's signature and add a clear method."""
+
+    def __call__(self, *args: P.args, **kwargs: P.kwargs) -> T_co: ...
+
+    @overload
+    def clear(self) -> None: ...
+
+    @overload
+    def clear(self, *args: P.args, **kwargs: P.kwargs) -> None: ...
+
+    # Currently we can't define the "all-optional" argument overload with `P.args` and `P.kwargs` in Python.
+    # So we use `Any` as a fallback.
+    @overload
+    def clear(self, *args: Any, **kwargs: Any) -> None: ...
+
+
 class CacheResourceAPI:
     """Implements the public st.cache_resource API: the @st.cache_resource decorator,
     and st.cache_resource.clear().
@@ -202,14 +234,9 @@ class CacheResourceAPI:
         # (Ignore spurious mypy complaints - https://github.com/python/mypy/issues/2427)
         self._decorator = gather_metrics(decorator_metric_name, self._decorator)  # type: ignore
 
-    # Type-annotate the decorator function.
-    # (See https://mypy.readthedocs.io/en/stable/generics.html#decorator-factories)
-
-    F = TypeVar("F", bound=Callable[..., Any])
-
     # Bare decorator usage
     @overload
-    def __call__(self, func: F) -> F: ...
+    def __call__(self, func: Callable[P, T_co]) -> CachedFunc[P, T_co]: ...
 
     # Decorator with arguments
     @overload
@@ -222,11 +249,11 @@ class CacheResourceAPI:
         validate: ValidateFunc | None = None,
         experimental_allow_widgets: bool = False,
         hash_funcs: HashFuncsDict | None = None,
-    ) -> Callable[[F], F]: ...
+    ) -> Callable[[Callable[P, T_co]], CachedFunc[P, T_co]]: ...
 
     def __call__(
         self,
-        func: F | None = None,
+        func: Callable[P, T_co] | None = None,
         *,
         ttl: float | timedelta | str | None = None,
         max_entries: int | None = None,
@@ -234,7 +261,7 @@ class CacheResourceAPI:
         validate: ValidateFunc | None = None,
         experimental_allow_widgets: bool = False,
         hash_funcs: HashFuncsDict | None = None,
-    ) -> F | Callable[[F], F]:
+    ) -> CachedFunc[P, T_co] | Callable[[Callable[P, T_co]], CachedFunc[P, T_co]]:
         return self._decorator(
             func,
             ttl=ttl,
@@ -247,7 +274,7 @@ class CacheResourceAPI:
 
     def _decorator(
         self,
-        func: F | None,
+        func: Callable[P, T_co] | None,
         *,
         ttl: float | timedelta | str | None,
         max_entries: int | None,
@@ -255,7 +282,7 @@ class CacheResourceAPI:
         validate: ValidateFunc | None,
         experimental_allow_widgets: bool,
         hash_funcs: HashFuncsDict | None = None,
-    ) -> F | Callable[[F], F]:
+    ) -> CachedFunc[P, T_co] | Callable[[Callable[P, T_co]], CachedFunc[P, T_co]]:
         """Decorator to cache functions that return global resources (e.g. database connections, ML models).
 
         Cached objects are shared across all users, sessions, and reruns. They

streamlit/static/index.html

@@ -37,7 +37,7 @@
     <script>
       window.prerenderReady = false
     </script>
-    <script type="module" crossorigin src="./static/js/index.BEHais2d.js"></script>
+    <script type="module" crossorigin src="./static/js/index.B6LxYHzZ.js"></script>
     <link rel="stylesheet" crossorigin href="./static/css/index.CJVRHjQZ.css">
   </head>
   <body>