streamlit 1.45.0__py3-none-any.whl → 1.46.0__py3-none-any.whl

streamlit/__init__.py

@@ -13,6 +13,7 @@
 # limitations under the License.
 
 # isort: skip_file
+# ruff: noqa: E402, PLC0414, A001
 
 """Streamlit.
 
@@ -286,7 +287,10 @@ experimental_dialog = _experimental_dialog_decorator
 experimental_fragment = _experimental_fragment
 experimental_user = _DeprecatedUserInfoProxy()
 
-_EXPERIMENTAL_QUERY_PARAMS_DEPRECATE_MSG = "Refer to our [docs page](https://docs.streamlit.io/develop/api-reference/caching-and-state/st.query_params) for more information."
+_EXPERIMENTAL_QUERY_PARAMS_DEPRECATE_MSG = (
+    "Refer to our [docs page](https://docs.streamlit.io/develop/api-reference/caching-and-state/st.query_params) "
+    "for more information."
+)
 
 experimental_get_query_params = _deprecate_func_name(
     _get_query_params,

streamlit/auth_util.py

@@ -32,28 +32,28 @@ if TYPE_CHECKING:
 class AuthCache:
     """Simple cache implementation for storing info required for Authlib."""
 
-    def __init__(self):
-        self.cache = {}
+    def __init__(self) -> None:
+        self.cache: dict[str, Any] = {}
 
-    def get(self, key):
+    def get(self, key: str) -> Any:
         return self.cache.get(key)
 
     # for set method, we are follow the same signature used in Authlib
     # the expires_in is not used in our case
-    def set(self, key, value, expires_in):
+    def set(self, key: str, value: Any, expires_in: int | None = None) -> None:  # noqa: ARG002
         self.cache[key] = value
 
-    def get_dict(self):
+    def get_dict(self) -> dict[str, Any]:
         return self.cache
 
-    def delete(self, key):
+    def delete(self, key: str) -> None:
         self.cache.pop(key, None)
 
 
 def is_authlib_installed() -> bool:
     """Check if Authlib is installed."""
     try:
-        import authlib  # type: ignore[import-untyped]
+        import authlib
 
         authlib_version = authlib.__version__
         authlib_version_tuple = tuple(map(int, authlib_version.split(".")))
@@ -87,7 +87,7 @@ def get_secrets_auth_section() -> AttrDict:
 def encode_provider_token(provider: str) -> str:
     """Returns a signed JWT token with the provider and expiration time."""
     try:
-        from authlib.jose import jwt  # type: ignore[import-untyped]
+        from authlib.jose import jwt
     except ImportError:
         raise StreamlitAuthError(
             """To use authentication features, you need to install Authlib>=1.3.2, e.g. via `pip install Authlib`."""
@@ -116,7 +116,7 @@ def decode_provider_token(provider_token: str) -> ProviderTokenPayload:
     # the 'exp' (and it is not expired), and 'provider' field exists.
     claim_options = {"exp": {"essential": True}, "provider": {"essential": True}}
     try:
-        payload: JWTClaims = jwt.decode(
+        payload: JWTClaims = jwt.decode(  # type: ignore[no-untyped-call]
             provider_token, get_signing_secret(), claims_options=claim_options
         )
         payload.validate()
@@ -126,7 +126,7 @@ def decode_provider_token(provider_token: str) -> ProviderTokenPayload:
     return cast("ProviderTokenPayload", payload)
 
 
-def generate_default_provider_section(auth_section) -> dict[str, Any]:
+def generate_default_provider_section(auth_section: AttrDict) -> dict[str, Any]:
     """Generate a default provider section for the 'auth' section of secrets.toml."""
     default_provider_section = {}
     if auth_section.get("client_id"):
@@ -138,8 +138,8 @@ def generate_default_provider_section(auth_section) -> dict[str, Any]:
             "server_metadata_url"
         )
     if auth_section.get("client_kwargs"):
-        default_provider_section["client_kwargs"] = auth_section.get(
-            "client_kwargs"
+        default_provider_section["client_kwargs"] = cast(
+            "AttrDict", auth_section.get("client_kwargs", AttrDict({}))
         ).to_dict()
     return default_provider_section
 

streamlit/cli_util.py

@@ -18,11 +18,12 @@ from __future__ import annotations
 
 import os
 import subprocess
+from typing import Any
 
 from streamlit import env_util, errors
 
 
-def print_to_cli(message: str, **kwargs) -> None:
+def print_to_cli(message: str, **kwargs: Any) -> None:
     """Print a message to the terminal using click if available, else print
     using the built-in print function.
 
@@ -36,7 +37,7 @@ def print_to_cli(message: str, **kwargs) -> None:
         print(message, flush=True)  # noqa: T201
 
 
-def style_for_cli(message: str, **kwargs) -> str:
+def style_for_cli(message: str, **kwargs: Any) -> str:
     """Style a message using click if available, else return the message
     unchanged.
 
@@ -60,7 +61,7 @@ def _open_browser_with_webbrowser(url: str) -> None:
 def _open_browser_with_command(command: str, url: str) -> None:
     cmd_line = [command, url]
     with open(os.devnull, "w") as devnull:
-        subprocess.Popen(cmd_line, stdout=devnull, stderr=subprocess.STDOUT)
+        subprocess.Popen(cmd_line, stdout=devnull, stderr=subprocess.STDOUT)  # noqa: S603
 
 
 def open_browser(url: str) -> None:

streamlit/column_config.py

@@ -12,27 +12,29 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-"""Column types that can be configured via the ``column_config`` parameter of ``st.dataframe`` and ``st.data_editor``."""
+"""Column types that can be configured via the ``column_config`` parameter of
+``st.dataframe`` and ``st.data_editor``.
+"""
 
 from __future__ import annotations
 
 __all__ = [
     "AreaChartColumn",
-    "Column",
-    "TextColumn",
-    "NumberColumn",
     "BarChartColumn",
     "CheckboxColumn",
+    "Column",
+    "DateColumn",
     "DatetimeColumn",
     "ImageColumn",
-    "SelectboxColumn",
-    "ProgressColumn",
-    "LinkColumn",
+    "JsonColumn",
     "LineChartColumn",
+    "LinkColumn",
     "ListColumn",
-    "DateColumn",
+    "NumberColumn",
+    "ProgressColumn",
+    "SelectboxColumn",
+    "TextColumn",
     "TimeColumn",
-    "JsonColumn",
 ]
 
 

streamlit/commands/echo.py

@@ -19,12 +19,12 @@ import contextlib
 import re
 import textwrap
 import traceback
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, Literal
 
 from streamlit.runtime.metrics_util import gather_metrics
 
 if TYPE_CHECKING:
-    from collections.abc import Iterable
+    from collections.abc import Generator, Iterable
 
 _SPACES_RE = re.compile("\\s*")
 _EMPTY_LINE_RE = re.compile("\\s*\n")
@@ -32,7 +32,9 @@ _EMPTY_LINE_RE = re.compile("\\s*\n")
 
 @gather_metrics("echo")
 @contextlib.contextmanager
-def echo(code_location="above"):
+def echo(
+    code_location: Literal["above", "below"] = "above",
+) -> Generator[None, None, None]:
     """Use in a `with` block to draw some code on the app, then execute it.
 
     Parameters
@@ -99,7 +101,7 @@ def echo(code_location="above"):
         show_code(code_string, "python")
 
     except FileNotFoundError as err:
-        show_warning("Unable to display code. %s" % err)
+        show_warning(f"Unable to display code. {err}")
 
 
 def _get_initial_indent(lines: Iterable[str]) -> int:

streamlit/commands/execution_control.py

@@ -64,41 +64,39 @@ def _new_fragment_id_queue(
     if scope == "app":
         return []
 
-    else:  # scope == "fragment"
-        curr_queue = ctx.fragment_ids_this_run
-
-        # If st.rerun(scope="fragment") is called during a full script run, we raise an
-        # exception. This occurs, of course, if st.rerun(scope="fragment") is called
-        # outside of a fragment, but it somewhat surprisingly occurs if it gets called
-        # from within a fragment during a run of the full script. While this behvior may
-        # be surprising, it seems somewhat reasonable given that the correct behavior of
-        # calling st.rerun(scope="fragment") in this situation is unclear to me:
-        #   * Rerunning just the fragment immediately may cause weirdness down the line
-        #     as any part of the script that occurs after the fragment will not be
-        #     executed.
-        #   * Waiting until the full script run completes before rerunning the fragment
-        #     seems odd (even if we normally do this before running a fragment not
-        #     triggered by st.rerun()) because it defers the execution of st.rerun().
-        #   * Rerunning the full app feels incorrect as we're seemingly ignoring the
-        #     `scope` argument.
-        # With these issues and given that it seems pretty unnatural to have a
-        # fragment-scoped rerun happen during a full script run to begin with, it seems
-        # reasonable to just disallow this completely for now.
-        if not curr_queue:
-            raise StreamlitAPIException(
-                'scope="fragment" can only be specified from `@st.fragment`-decorated '
-                "functions during fragment reruns."
-            )
+    # > scope == "fragment"
+    curr_queue = ctx.fragment_ids_this_run
+
+    # If st.rerun(scope="fragment") is called during a full script run, we raise an
+    # exception. This occurs, of course, if st.rerun(scope="fragment") is called
+    # outside of a fragment, but it somewhat surprisingly occurs if it gets called
+    # from within a fragment during a run of the full script. While this behavior may
+    # be surprising, it seems somewhat reasonable given that the correct behavior of
+    # calling st.rerun(scope="fragment") in this situation is unclear to me:
+    #   * Rerunning just the fragment immediately may cause weirdness down the line
+    #     as any part of the script that occurs after the fragment will not be
+    #     executed.
+    #   * Waiting until the full script run completes before rerunning the fragment
+    #     seems odd (even if we normally do this before running a fragment not
+    #     triggered by st.rerun()) because it defers the execution of st.rerun().
+    #   * Rerunning the full app feels incorrect as we're seemingly ignoring the
+    #     `scope` argument.
+    # With these issues and given that it seems pretty unnatural to have a
+    # fragment-scoped rerun happen during a full script run to begin with, it seems
+    # reasonable to just disallow this completely for now.
+    if not curr_queue:
+        raise StreamlitAPIException(
+            'scope="fragment" can only be specified from `@st.fragment`-decorated '
+            "functions during fragment reruns."
+        )
 
-        assert (
-            new_queue := list(
-                dropwhile(lambda x: x != ctx.current_fragment_id, curr_queue)
-            )
-        ), (
+    new_queue = list(dropwhile(lambda x: x != ctx.current_fragment_id, curr_queue))
+    if not new_queue:
+        raise RuntimeError(
             "Could not find current_fragment_id in fragment_id_queue. This should never happen."
         )
 
-        return new_queue
+    return new_queue
 
 
 @gather_metrics("rerun")
@@ -222,7 +220,9 @@ def switch_page(page: str | Path | StreamlitPage) -> NoReturn:  # type: ignore[m
 
         if len(matched_pages) == 0:
             raise StreamlitAPIException(
-                f"Could not find page: `{page}`. Must be the file path relative to the main script, from the directory: `{os.path.basename(main_script_directory)}`. Only the main app file and files in the `pages/` directory are supported."
+                f"Could not find page: `{page}`. Must be the file path relative to the main script, "
+                f"from the directory: `{os.path.basename(main_script_directory)}`. Only the main app file "
+                "and files in the `pages/` directory are supported."
             )
 
         page_script_hash = matched_pages[0]["page_script_hash"]
@@ -236,6 +236,7 @@ def switch_page(page: str | Path | StreamlitPage) -> NoReturn:  # type: ignore[m
             query_string=ctx.query_string,
             page_script_hash=page_script_hash,
             cached_message_hashes=ctx.cached_message_hashes,
+            context_info=ctx.context_info,
         )
     )
     # Force a yield point so the runner can do the rerun

streamlit/commands/experimental_query_params.py

@@ -14,8 +14,8 @@
 
 from __future__ import annotations
 
-import urllib.parse as parse
 from typing import Any
+from urllib import parse
 
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.ForwardMsg_pb2 import ForwardMsg
@@ -123,7 +123,7 @@ def _extract_key_query_params(
         item.lower()
         for sublist in [
             [value.lower() for value in query_params[key]]
-            for key in query_params.keys()
+            for key in query_params
             if key.lower() == param_key and query_params.get(key)
         ]
         for item in sublist

streamlit/commands/logo.py

@@ -26,8 +26,12 @@ from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner_utils.script_run_context import get_script_run_ctx
 
 
-def _invalid_logo_text(field_name: str):
-    return f"The {field_name} passed to st.logo is invalid - See [documentation](https://docs.streamlit.io/develop/api-reference/media/st.logo) for more information on valid types"
+def _invalid_logo_text(field_name: str) -> str:
+    return (
+        f"The {field_name} passed to st.logo is invalid - See "
+        "[documentation](https://docs.streamlit.io/develop/api-reference/media/st.logo) "
+        "for more information on valid types"
+    )
 
 
 @gather_metrics("logo")
@@ -154,7 +158,8 @@ def logo(
             fwd_msg.logo.link = link
         else:
             raise StreamlitAPIException(
-                f"Invalid link: {link} - the link param supports external links only and must start with either http:// or https://."
+                f"Invalid link: {link} - the link param supports external links only and must "
+                f"start with either http:// or https://."
             )
 
     if icon_image:
@@ -171,7 +176,7 @@ def logo(
         except Exception as ex:
             raise StreamlitAPIException(_invalid_logo_text("icon_image")) from ex
 
-    def validate_size(size):
+    def validate_size(size: str) -> str:
         if isinstance(size, str):
             image_size = size.lower()
             valid_sizes = ["small", "medium", "large"]

streamlit/commands/navigation.py

@@ -68,13 +68,12 @@ def pages_from_nav_sections(
 ) -> list[StreamlitPage]:
     page_list = []
     for pages in nav_sections.values():
-        for page in pages:
-            page_list.append(page)
+        page_list.extend(pages.copy())
 
     return page_list
 
 
-def send_page_not_found(ctx: ScriptRunContext):
+def send_page_not_found(ctx: ScriptRunContext) -> None:
     msg = ForwardMsg()
     msg.page_not_found.page_name = ""
     ctx.enqueue(msg)
@@ -84,7 +83,7 @@ def send_page_not_found(ctx: ScriptRunContext):
 def navigation(
     pages: Sequence[PageType] | Mapping[SectionHeader, Sequence[PageType]],
     *,
-    position: Literal["sidebar", "hidden"] = "sidebar",
+    position: Literal["sidebar", "hidden", "top"] = "sidebar",
     expanded: bool = False,
 ) -> StreamlitPage:
     """
@@ -121,7 +120,8 @@ def navigation(
         To create labeled sections or page groupings within the navigation
         menu, ``pages`` must be a dictionary. Each key is the label of a
         section and each value is the list of page-like objects for
-        that section.
+        that section. If you use ``position="top"``, each grouping will be a
+        collapsible item in the navigation menu.
 
         When you use a string or path as a page-like object, they are
         internally passed to ``st.Page`` and converted to ``StreamlitPage``
@@ -129,10 +129,11 @@ def navigation(
         path inferred from its path or filename. To customize these attributes
         for your page, initialize your page with ``st.Page``.
 
-    position : "sidebar" or "hidden"
+    position : "sidebar", "top", or "hidden"
         The position of the navigation menu. If this is ``"sidebar"``
         (default), the navigation widget appears at the top of the sidebar. If
-        this is ``"hidden"``, the navigation widget is not displayed.
+        this is ``"top"``, the navigation appears in the top header of the app.
+        If this is ``"hidden"``, the navigation widget is not displayed.
 
         If there is only one page in ``pages``, the navigation will be hidden
         for any value of ``position``.
@@ -148,6 +149,8 @@ def navigation(
         ``expanded=False`` on a rerun, the menu will stay expanded and a
         collapse button will be displayed.
 
+        The parameter is only used when ``position="sidebar"``.
+
     Returns
     -------
     StreamlitPage
@@ -226,7 +229,38 @@ def navigation(
         https://doc-navigation-example-2.streamlit.app/
         height: 300px
 
-    **Example 3: Stateful widgets across multiple pages**
+
+    **Example 3: Use top navigation**
+
+    You can use the ``position`` parameter to place the navigation at the top
+    of the app. This is useful for apps with a lot of pages because it allows
+    you to create collapsible sections for each group of pages. The following
+    example uses the same directory structure as Example 2 and shows how to
+    create a top navigation menu.
+
+    ``streamlit_app.py``:
+
+    >>> import streamlit as st
+    >>>
+    >>> pages = {
+    ...     "Your account": [
+    ...         st.Page("create_account.py", title="Create your account"),
+    ...         st.Page("manage_account.py", title="Manage your account"),
+    ...     ],
+    ...     "Resources": [
+    ...         st.Page("learn.py", title="Learn about us"),
+    ...         st.Page("trial.py", title="Try it out"),
+    ...     ],
+    ... }
+    >>>
+    >>> pg = st.navigation(pages, position="top")
+    >>> pg.run()
+
+    .. output::
+        https://doc-navigation-top.streamlit.app/
+        height: 300px
+
+    **Example 4: Stateful widgets across multiple pages**
 
     Call widget functions in your entrypoint file when you want a widget to be
     stateful across pages. Assign keys to your common widgets and access their
@@ -257,6 +291,13 @@ def navigation(
     .. _st.Page: https://docs.streamlit.io/develop/api-reference/navigation/st.page
 
     """
+    # Validate position parameter
+    if not isinstance(position, str) or position not in ["sidebar", "hidden", "top"]:
+        raise StreamlitAPIException(
+            f'Invalid position "{position}". '
+            'The position parameter must be one of "sidebar", "hidden", or "top".'
+        )
+
     # Disable the use of the pages feature (ie disregard v1 behavior of Multipage Apps)
     PagesManager.uses_pages_directory = False
 
@@ -266,7 +307,7 @@ def navigation(
 def _navigation(
     pages: Sequence[PageType] | Mapping[SectionHeader, Sequence[PageType]],
     *,
-    position: Literal["sidebar", "hidden"],
+    position: Literal["sidebar", "hidden", "top"],
     expanded: bool,
 ) -> StreamlitPage:
     if isinstance(pages, Sequence):
@@ -312,14 +353,11 @@ def _navigation(
     # Build the pagehash-to-pageinfo mapping.
     for section_header in nav_sections:
         for page in nav_sections[section_header]:
-            if isinstance(page._page, Path):
-                script_path = str(page._page)
-            else:
-                script_path = ""
+            script_path = str(page._page) if isinstance(page._page, Path) else ""
 
             script_hash = page._script_hash
             if script_hash in pagehash_to_pageinfo:
-                # The page script hash is soley based on the url path
+                # The page script hash is solely based on the url path
                 # So duplicate page script hashes are due to duplicate url paths
                 raise StreamlitAPIException(
                     f"Multiple Pages specified with URL pathname {page.url_path}. "
@@ -336,12 +374,17 @@ def _navigation(
             }
 
     msg = ForwardMsg()
+    # Handle position logic correctly
     if position == "hidden":
         msg.navigation.position = NavigationProto.Position.HIDDEN
-    elif config.get_option("client.showSidebarNavigation") is False:
-        msg.navigation.position = NavigationProto.Position.HIDDEN
-    else:
-        msg.navigation.position = NavigationProto.Position.SIDEBAR
+    elif position == "top":
+        msg.navigation.position = NavigationProto.Position.TOP
+    elif position == "sidebar":
+        # Only apply config override if position is sidebar
+        if config.get_option("client.showSidebarNavigation") is False:
+            msg.navigation.position = NavigationProto.Position.HIDDEN
+        else:
+            msg.navigation.position = NavigationProto.Position.SIDEBAR
 
     msg.navigation.expanded = expanded
     msg.navigation.sections[:] = nav_sections.keys()