streamlit-nightly 1.45.2.dev20250512__py3-none-any.whl → 1.45.2.dev20250514__py3-none-any.whl

streamlit/elements/widgets/radio.py

@@ -341,12 +341,11 @@ class RadioMixin:
         def handle_captions(caption: str | None) -> str:
             if caption is None:
                 return ""
-            elif isinstance(caption, str):
+            if isinstance(caption, str):
                 return caption
-            else:
-                raise StreamlitAPIException(
-                    f"Radio captions must be strings. Passed type: {type(caption).__name__}"
-                )
+            raise StreamlitAPIException(
+                f"Radio captions must be strings. Passed type: {type(caption).__name__}"
+            )
 
         session_state = get_session_state().filtered_state
         if key is not None and key in session_state and session_state[key] is None:

streamlit/elements/widgets/select_slider.py

@@ -102,8 +102,7 @@ class SelectSliderSerde(Generic[T]):
             if start > end:
                 slider_value = [end, start]
             return slider_value
-        else:
-            return [index_(self.options, v)]
+        return [index_(self.options, v)]
 
 
 class SelectSliderMixin:
@@ -367,15 +366,14 @@ class SelectSliderMixin:
                 if start > end:
                     slider_value = [end, start]
                 return slider_value
-            else:
-                # Simplify future logic by always making value a list
-                try:
-                    return [index_(opt, v)]
-                except ValueError:
-                    if value is not None:
-                        raise
-
-                    return [0]
+            # Simplify future logic by always making value a list
+            try:
+                return [index_(opt, v)]
+            except ValueError:
+                if value is not None:
+                    raise
+
+                return [0]
 
         # Convert element to index of the elements
         slider_value = as_index_list(value)

streamlit/elements/widgets/slider.py

@@ -692,7 +692,7 @@ class SliderMixin:
         if single_value:
             value = [value]
 
-        def value_to_generic_type(v):
+        def value_to_generic_type(v: Any) -> SliderProto.DataType.ValueType:
             if isinstance(v, Integral):
                 return SUPPORTED_TYPES[Integral]
             if isinstance(v, Real):

streamlit/elements/write.py

@@ -156,7 +156,7 @@ class WriteMixin:
         streamed_response: str = ""
         written_content: list[Any] = StreamingOutput()
 
-        def flush_stream_response():
+        def flush_stream_response() -> None:
             """Write the full response to the app."""
             nonlocal streamed_response
             nonlocal stream_container
@@ -428,7 +428,7 @@ class WriteMixin:
                 "when called as `st.write()` or `st.sidebar.write()`."
             )
 
-        def flush_buffer():
+        def flush_buffer() -> None:
             if string_buffer:
                 text_content = " ".join(string_buffer)
                 # The usage of empty here prevents

streamlit/error_util.py

@@ -14,7 +14,7 @@
 
 from __future__ import annotations
 
-from typing import Final
+from typing import Any, Final
 
 import streamlit
 from streamlit import config
@@ -26,17 +26,24 @@ _LOGGER: Final = get_logger(__name__)
 
 
 def _print_rich_exception(e: BaseException) -> None:
-    from rich import box, panel
+    from rich.box import Box
+    from rich.panel import Panel
 
     # Monkey patch the panel to use our custom box style
-    class ConfigurablePanel(panel.Panel):
+    class ConfigurablePanel(Panel):
         def __init__(
             self,
-            renderable,
-            box=box.Box("────\n    \n────\n    \n────\n────\n    \n────\n"),
-            **kwargs,
-        ):
-            super().__init__(renderable, box, **kwargs)
+            renderable: Any,
+            box: Box | None = None,
+            **kwargs: Any,
+        ) -> None:
+            super().__init__(
+                renderable,
+                box
+                if box is not None
+                else Box("────\n    \n────\n    \n────\n────\n    \n────\n"),
+                **kwargs,
+            )
 
     from rich import traceback as rich_traceback
 

streamlit/errors.py

@@ -20,6 +20,7 @@ from typing import TYPE_CHECKING, Any, Literal
 from streamlit import util
 
 if TYPE_CHECKING:
+    from collections.abc import Collection
     from datetime import date, time
 
 
@@ -140,7 +141,7 @@ class StreamlitAPIWarning(StreamlitAPIException, Warning):
     instead.
     """
 
-    def __init__(self, *args):
+    def __init__(self, *args: Any) -> None:
         super().__init__(*args)
         import inspect
         import traceback
@@ -157,7 +158,7 @@ class StreamlitModuleNotFoundError(StreamlitAPIWarning):
     that is not one of our core dependencies.
     """
 
-    def __init__(self, module_name, *args):
+    def __init__(self, module_name: str, *args: Any) -> None:
         message = (
             f'This Streamlit command requires module "{module_name}" to be installed.'
         )
@@ -220,7 +221,7 @@ class StreamlitInvalidURLError(LocalizableStreamlitException):
 class StreamlitInvalidColumnSpecError(LocalizableStreamlitException):
     """Exception raised when no weights are specified, or a negative weight is specified."""
 
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__(
             "The `spec` argument to `st.columns` must be either a "
             "positive integer (number of columns) or a list of positive numbers (width ratios of the columns). "
@@ -370,7 +371,7 @@ class StreamlitInvalidNumberFormatError(LocalizableStreamlitException):
 class StreamlitMissingPageLabelError(LocalizableStreamlitException):
     """Exception raised when a page_link is created without a label."""
 
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__(
             "The `label` param is required for external links used with `st.page_link` - please provide a `label`."
         )
@@ -409,7 +410,7 @@ class StreamlitPageNotFoundError(LocalizableStreamlitException):
 class StreamlitFragmentWidgetsNotAllowedOutsideError(LocalizableStreamlitException):
     """Exception raised when the fragment attempts to write to an element outside of its container."""
 
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__("Fragments cannot write widgets to outside containers.")
 
 
@@ -418,7 +419,7 @@ class StreamlitInvalidFormCallbackError(LocalizableStreamlitException):
     the `st.form_submit_button`.
     """
 
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__(
             "Within a form, callbacks can only be defined on `st.form_submit_button`. "
             "Defining callbacks on other widgets inside a form is not allowed."
@@ -436,7 +437,9 @@ class StreamlitValueAssignmentNotAllowedError(LocalizableStreamlitException):
 
 
 class StreamlitInvalidColorError(LocalizableStreamlitException):
-    def __init__(self, color):
+    def __init__(
+        self, color: str | Collection[Any] | tuple[int, int, int, int]
+    ) -> None:
         super().__init__(
             "This does not look like a valid color: {color}.\n\n"
             "Colors must be in one of the following formats:"

streamlit/file_util.py

@@ -19,11 +19,14 @@ import errno
 import io
 import os
 from pathlib import Path
-from typing import Final
+from typing import IO, TYPE_CHECKING, Any, Final
 
 from streamlit import env_util, errors
 from streamlit.string_util import is_binary_string
 
+if TYPE_CHECKING:
+    from collections.abc import Generator
+
 # Configuration and credentials are stored inside the ~/.streamlit folder
 CONFIG_FOLDER_NAME: Final = ".streamlit"
 
@@ -63,7 +66,7 @@ def get_encoded_file_data(
 
 
 @contextlib.contextmanager
-def streamlit_read(path, binary=False):
+def streamlit_read(path: str, binary: bool = False) -> Generator[IO[Any], None, None]:
     """Opens a context to read this file relative to the streamlit path.
 
     For example:
@@ -88,7 +91,7 @@ def streamlit_read(path, binary=False):
 
 
 @contextlib.contextmanager
-def streamlit_write(path, binary=False):
+def streamlit_write(path: str, binary: bool = False) -> Generator[IO[Any], None, None]:
     """Opens a file for writing within the streamlit path, and
     ensuring that the path exists.
 

streamlit/git_util.py

@@ -16,10 +16,13 @@ from __future__ import annotations
 
 import os
 import re
-from typing import Any
+from typing import TYPE_CHECKING, cast
 
 from streamlit import util
 
+if TYPE_CHECKING:
+    from git import Commit, Remote, RemoteReference, Repo
+
 # Github has two URLs, one that is https and one that is ssh
 GITHUB_HTTP_URL = r"^https://(www\.)?github.com/(.+)/(.+)(?:.git)?$"
 GITHUB_SSH_URL = r"^git@github.com:(.+)/(.+)(?:.git)?$"
@@ -31,7 +34,9 @@ MIN_GIT_VERSION = (2, 7, 0)
 
 
 class GitRepo:
-    def __init__(self, path):
+    repo: Repo | None
+
+    def __init__(self, path: str) -> None:
         # If we have a valid repo, git_version will be a tuple
         # of 3+ ints: (major, minor, patch, possible_additional_patch_number)
         self.git_version: tuple[int, ...] | None = None
@@ -39,11 +44,7 @@ class GitRepo:
         try:
             import git
 
-            # GitPython is not fully typed, and mypy is outputting inconsistent
-            # type errors on Mac and Linux. We bypass type checking entirely
-            # by redeclaring the `git` import as an "Any".
-            git_package: Any = git
-            self.repo = git_package.Repo(path, search_parent_directories=True)
+            self.repo = git.Repo(path, search_parent_directories=True)
             self.git_version = self.repo.git.version_info
 
             if self.git_version >= MIN_GIT_VERSION:
@@ -69,8 +70,8 @@ class GitRepo:
         )
 
     @property
-    def tracking_branch(self):
-        if not self.is_valid():
+    def tracking_branch(self) -> RemoteReference | None:
+        if self.repo is None or not self.is_valid():
             return None
 
         if self.is_head_detached:
@@ -79,41 +80,45 @@ class GitRepo:
         return self.repo.active_branch.tracking_branch()
 
     @property
-    def untracked_files(self):
-        if not self.is_valid():
+    def untracked_files(self) -> list[str] | None:
+        if self.repo is None or not self.is_valid():
             return None
 
         return self.repo.untracked_files
 
     @property
-    def is_head_detached(self):
-        if not self.is_valid():
+    def is_head_detached(self) -> bool:
+        if self.repo is None or not self.is_valid():
             return False
 
         return self.repo.head.is_detached
 
     @property
-    def uncommitted_files(self):
-        if not self.is_valid():
+    def uncommitted_files(self) -> list[str] | None:
+        if self.repo is None or not self.is_valid():
             return None
 
-        return [item.a_path for item in self.repo.index.diff(None)]
+        return [cast("str", item.a_path) for item in self.repo.index.diff(None)]
 
     @property
-    def ahead_commits(self):
-        if not self.is_valid():
+    def ahead_commits(self) -> list[Commit] | None:
+        if self.repo is None or not self.is_valid():
             return None
 
         try:
-            remote, branch_name = self.get_tracking_branch_remote()
+            tracking_branch_info = self.get_tracking_branch_remote()
+            if tracking_branch_info is None:
+                return None
+
+            remote, branch_name = tracking_branch_info
             remote_branch = f"{remote.name}/{branch_name}"
 
             return list(self.repo.iter_commits(f"{remote_branch}..{branch_name}"))
         except Exception:
             return []
 
-    def get_tracking_branch_remote(self):
-        if not self.is_valid():
+    def get_tracking_branch_remote(self) -> tuple[Remote, str] | None:
+        if self.repo is None or not self.is_valid():
             return None
 
         tracking_branch = self.tracking_branch

streamlit/hello/dataframe_demo.py

@@ -21,7 +21,7 @@ import streamlit as st
 from streamlit.hello.utils import show_code
 
 
-def data_frame_demo():
+def data_frame_demo() -> None:
     @st.cache_data
     def get_un_data() -> pd.DataFrame:
         AWS_BUCKET_URL = "https://streamlit-demo-data.s3-us-west-2.amazonaws.com"

streamlit/hello/mapping_demo.py

@@ -21,7 +21,7 @@ import streamlit as st
 from streamlit.hello.utils import show_code
 
 
-def mapping_demo():
+def mapping_demo() -> None:
     @st.cache_data
     def from_data_file(filename: str) -> pd.DataFrame:
         url = (

streamlit/hello/plotting_demo.py

@@ -20,14 +20,14 @@ import streamlit as st
 from streamlit.hello.utils import show_code
 
 
-def plotting_demo():
+def plotting_demo() -> None:
     progress_bar = st.sidebar.progress(0)
     status_text = st.sidebar.empty()
-    last_rows = np.random.randn(1, 1)
+    last_rows = np.random.randn(1, 1)  # noqa: NPY002
     chart = st.line_chart(last_rows)
 
     for i in range(1, 101):
-        new_rows = last_rows[-1, :] + np.random.randn(5, 1).cumsum(axis=0)
+        new_rows = last_rows[-1, :] + np.random.randn(5, 1).cumsum(axis=0)  # noqa: NPY002
         status_text.text(f"{i}% complete")
         chart.add_rows(new_rows)
         progress_bar.progress(i)

streamlit/hello/streamlit_app.py

@@ -20,7 +20,7 @@ dir_path = Path(__file__).parent
 
 
 # Note that this needs to be in a method so we can have an e2e playwright test.
-def run():
+def run() -> None:
     page = st.navigation(
         [
             st.Page(

streamlit/hello/utils.py

@@ -14,11 +14,12 @@
 
 import inspect
 import textwrap
+from typing import Any, Callable
 
 import streamlit as st
 
 
-def show_code(demo):
+def show_code(demo: Callable[..., Any]) -> None:
     """Showing the code of the demo."""
     show_code = st.sidebar.checkbox("Show code", True)
     if show_code:

streamlit/navigation/page.py

@@ -289,12 +289,11 @@ class StreamlitPage:
             if callable(self._page):
                 self._page()
                 return
-            else:
-                code = ctx.pages_manager.get_page_script_byte_code(str(self._page))
-                module = types.ModuleType("__main__")
-                # We want __file__ to be the string path to the script
-                module.__dict__["__file__"] = str(self._page)
-                exec(code, module.__dict__)  # noqa: S102
+            code = ctx.pages_manager.get_page_script_byte_code(str(self._page))
+            module = types.ModuleType("__main__")
+            # We want __file__ to be the string path to the script
+            module.__dict__["__file__"] = str(self._page)
+            exec(code, module.__dict__)  # noqa: S102
 
     @property
     def _script_hash(self) -> str:

streamlit/runtime/app_session.py

@@ -151,7 +151,7 @@ class AppSession:
         self._client_state = ClientState()
 
         self._local_sources_watcher: LocalSourcesWatcher | None = None
-        self._stop_config_listener: Callable[[], bool] | None = None
+        self._stop_config_listener: Callable[[], None] | None = None
         self._stop_pages_listener: Callable[[], None] | None = None
 
         if config.get_option("server.fileWatcherType") != "none":
@@ -792,12 +792,12 @@ class AppSession:
             msg.git_info_changed.branch = branch
             msg.git_info_changed.module = module
 
-            msg.git_info_changed.untracked_files[:] = repo.untracked_files
-            msg.git_info_changed.uncommitted_files[:] = repo.uncommitted_files
+            msg.git_info_changed.untracked_files[:] = repo.untracked_files or []
+            msg.git_info_changed.uncommitted_files[:] = repo.uncommitted_files or []
 
             if repo.is_head_detached:
                 msg.git_info_changed.state = GitInfo.GitStates.HEAD_DETACHED
-            elif len(repo.ahead_commits) > 0:
+            elif repo.ahead_commits and len(repo.ahead_commits) > 0:
                 msg.git_info_changed.state = GitInfo.GitStates.AHEAD_OF_REMOTE
             else:
                 msg.git_info_changed.state = GitInfo.GitStates.DEFAULT

streamlit/runtime/caching/cache_data_api.py

@@ -147,7 +147,7 @@ class CachedDataFuncInfo(CachedFuncInfo):
 class DataCaches(CacheStatsProvider):
     """Manages all DataCache instances."""
 
-    def __init__(self):
+    def __init__(self) -> None:
         self._caches_lock = threading.Lock()
         self._function_caches: dict[str, DataCache] = {}
 
@@ -566,7 +566,7 @@ class CacheDataAPI:
         if experimental_allow_widgets:
             show_widget_replay_deprecation("cache_data")
 
-        def wrapper(f):
+        def wrapper(f):  # noqa: ANN001, ANN202
             return make_cached_func_wrapper(
                 CachedDataFuncInfo(
                     func=f,

streamlit/runtime/caching/cache_errors.py

@@ -30,7 +30,7 @@ def get_cached_func_name_md(func: Any) -> str:
     """Get markdown representation of the function name."""
     if hasattr(func, "__name__"):
         return f"`{func.__name__}()`"
-    elif hasattr(type(func), "__name__"):
+    if hasattr(type(func), "__name__"):
         return f"`{type(func).__name__}`"
     return f"`{type(func)}`"
 

streamlit/runtime/caching/cache_resource_api.py

@@ -69,7 +69,7 @@ def _equal_validate_funcs(a: ValidateFunc | None, b: ValidateFunc | None) -> boo
 class ResourceCaches(CacheStatsProvider):
     """Manages all ResourceCache instances."""
 
-    def __init__(self):
+    def __init__(self) -> None:
         self._caches_lock = threading.Lock()
         self._function_caches: dict[str, ResourceCache] = {}
 

streamlit/runtime/caching/cache_utils.py

@@ -65,7 +65,7 @@ TTLCACHE_TIMER = time.monotonic
 class Cache:
     """Function cache interface. Caches persist across script runs."""
 
-    def __init__(self):
+    def __init__(self) -> None:
         self._value_locks: dict[str, threading.Lock] = defaultdict(threading.Lock)
         self._value_locks_lock = threading.Lock()
 
@@ -196,7 +196,7 @@ class CachedFunc:
     def __repr__(self) -> str:
         return f"<CachedFunc: {self._info.func}>"
 
-    def __get__(self, instance, owner=None):
+    def __get__(self, instance: Any, owner: Any | None = None) -> Any:
         """CachedFunc implements descriptor protocol to support cache methods."""
         if instance is None:
             return self
@@ -346,7 +346,7 @@ class CachedFunc:
                     return_value=computed_value, func=self._info.func
                 )
 
-    def clear(self, *args, **kwargs):
+    def clear(self, *args: Any, **kwargs: Any) -> None:
         """Clear the cached function's associated cache.
 
         If no arguments are passed, Streamlit will clear all values cached for

streamlit/runtime/caching/cached_message_replay.py

@@ -218,8 +218,7 @@ class CachedMessageReplayContext(threading.local):
         """
         if len(self._seen_dg_stack) > 0 and acting_on_id in self._seen_dg_stack[-1]:
             return acting_on_id
-        else:
-            return invoked_id
+        return invoked_id
 
     def save_image_data(
         self, image_data: bytes | str, mimetype: str, image_id: str

streamlit/runtime/caching/hashing.py

@@ -182,7 +182,7 @@ class _HashStack:
     This causes the "in" to crash since it expects a boolean.
     """
 
-    def __init__(self):
+    def __init__(self) -> None:
         self._stack: collections.OrderedDict[int, list[Any]] = collections.OrderedDict()
         # A function that we decorate with streamlit cache
         # primitive (st.cache_data or st.cache_resource).
@@ -213,7 +213,7 @@ class _HashStack:
 class _HashStacks:
     """Stacks of what has been hashed, with at most 1 stack per thread."""
 
-    def __init__(self):
+    def __init__(self) -> None:
         self._stacks: weakref.WeakKeyDictionary[threading.Thread, _HashStack] = (
             weakref.WeakKeyDictionary()
         )

streamlit/runtime/caching/storage/in_memory_cache_storage_wrapper.py

@@ -131,9 +131,8 @@ class InMemoryCacheStorageWrapper(CacheStorage):
                 _LOGGER.debug("Memory cache HIT: %s", key)
                 return entry
 
-            else:
-                _LOGGER.debug("Memory cache MISS: %s", key)
-                raise CacheStorageKeyNotFoundError("Key not found in mem cache")
+            _LOGGER.debug("Memory cache MISS: %s", key)
+            raise CacheStorageKeyNotFoundError("Key not found in mem cache")
 
     def _write_to_mem_cache(self, key: str, entry_bytes: bytes) -> None:
         with self._mem_cache_lock:

streamlit/runtime/context.py

@@ -328,11 +328,7 @@ class ContextProxy:
         url_without_page_prefix = maybe_trim_page_path(
             url_from_frontend, ctx.pages_manager
         )
-        url_with_page_prefix = maybe_add_page_path(
-            url_without_page_prefix, ctx.pages_manager
-        )
-
-        return url_with_page_prefix
+        return maybe_add_page_path(url_without_page_prefix, ctx.pages_manager)
 
     @property
     @gather_metrics("context.ip_address")

streamlit/runtime/credentials.py

@@ -66,7 +66,7 @@ Collecting usage statistics. To deactivate, set browser.gatherUsageStats to fals
 """
 
 
-def _send_email(email: str) -> None:
+def _send_email(email: str | None) -> None:
     """Send the user's email for metrics, if submitted."""
     import requests
 
@@ -124,15 +124,15 @@ class Credentials:
 
         return cast("Credentials", Credentials._singleton)
 
-    def __init__(self):
+    def __init__(self) -> None:
         """Initialize class."""
         if Credentials._singleton is not None:
             raise RuntimeError(
                 "Credentials already initialized. Use .get_current() instead"
             )
 
-        self.activation = None
-        self._conf_file = _get_credential_file_path()
+        self.activation: _Activation | None = None
+        self._conf_file: str = _get_credential_file_path()
 
         Credentials._singleton = self
 

streamlit/runtime/forward_msg_queue.py

@@ -41,7 +41,7 @@ class ForwardMsgQueue:
         """
         ForwardMsgQueue._before_enqueue_msg = before_enqueue_msg
 
-    def __init__(self):
+    def __init__(self) -> None:
         self._queue: list[ForwardMsg] = []
         # A mapping of (delta_path -> _queue.indexof(msg)) for each
         # Delta message in the queue. We use this for coalescing

streamlit/runtime/media_file_manager.py

@@ -38,8 +38,7 @@ def _get_session_id() -> str:
         # "streamlit run myscript.py". In which case the session ID doesn't
         # matter and can just be a constant, as there's only ever "session".
         return "dontcare"
-    else:
-        return ctx.session_id
+    return ctx.session_id
 
 
 class MediaFileMetadata:

streamlit/runtime/memory_uploaded_file_manager.py

@@ -92,7 +92,7 @@ class MemoryUploadedFileManager(UploadedFileManager):
 
         self.file_storage[session_id][file.file_id] = file
 
-    def remove_file(self, session_id, file_id):
+    def remove_file(self, session_id: str, file_id: str) -> None:
         """Remove file with given file_id associated with a given session."""
         session_storage = self.file_storage[session_id]
         session_storage.pop(file_id, None)

streamlit/runtime/metrics_util.py

@@ -228,7 +228,7 @@ class Installation:
                     cls._instance = Installation()
         return cls._instance
 
-    def __init__(self):
+    def __init__(self) -> None:
         self.installation_id_v3 = str(
             uuid.uuid5(uuid.NAMESPACE_DNS, _get_machine_id_v3())
         )

streamlit/runtime/runtime.py

@@ -313,7 +313,7 @@ class Runtime:
 
         async_objs = self._get_async_objs()
 
-        def stop_on_eventloop():
+        def stop_on_eventloop() -> None:
             if self._state in (RuntimeState.STOPPING, RuntimeState.STOPPED):
                 return
 

streamlit/runtime/scriptrunner/exec_code.py

@@ -50,7 +50,7 @@ class modified_sys_path:  # noqa: N801
     def __repr__(self) -> str:
         return util.repr_(self)
 
-    def __enter__(self):
+    def __enter__(self) -> None:
         if self._main_script_path not in sys.path:
             sys.path.insert(0, self._main_script_path)
             self._added_path = True