streamlit-nightly 1.45.2.dev20250616__py3-none-any.whl → 1.45.2.dev20250617__py3-none-any.whl

streamlit/commands/navigation.py

@@ -120,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``
@@ -128,11 +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", "hidden", or "top"
+    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. If this
-        is ``"top"``, the navigation appears in the top header of the app.
+        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

streamlit/commands/page_config.py

@@ -110,26 +110,34 @@ def _get_favicon_string(page_icon: PageIcon) -> str:
 def set_page_config(
     page_title: str | None = None,
     page_icon: PageIcon | None = None,
-    layout: Layout = "centered",
-    initial_sidebar_state: InitialSideBarState = "auto",
+    layout: Layout | None = None,
+    initial_sidebar_state: InitialSideBarState | None = None,
     menu_items: MenuItems | None = None,
 ) -> None:
     """
-    Configures the default settings of the page.
+    Configure the default settings of the page.
 
-    .. note::
-        This must be the first Streamlit command used on an app page, and must only
-        be set once per page.
+    This command can be called multiple times in a script run to dynamically
+    change the page configuration. The calls are additive, with each successive
+    call overriding only the parameters that are specified.
 
     Parameters
     ----------
     page_title: str or None
-        The page title, shown in the browser tab. If None, defaults to the
-        filename of the script ("app.py" would show "app • Streamlit").
+        The page title, shown in the browser tab. If this is ``None``
+        (default), the page title is inherited from the previous call of
+        ``st.set_page_config``. If this is ``None`` and no previous call
+        exists, the page title is inferred from the page source.
+
+        If a page source is a Python file, its inferred title is derived from
+        the filename. If a page source is a callable object, its inferred title
+        is derived from the callable's name.
 
     page_icon : Anything supported by st.image (except list), str, or None
-        The page favicon. If ``page_icon`` is ``None`` (default), the favicon
-        will be a monochrome Streamlit logo.
+        The page favicon. If ``page_icon`` is ``None`` (default), the page icon
+        is inherited from the previous call of ``st.set_page_config``. If this
+        is ``None`` and no previous call exists, the favicon is a monochrome
+        Streamlit logo.
 
         In addition to the types supported by |st.image|_ (except list), the
         following strings are valid:
@@ -160,17 +168,29 @@ def set_page_config(
         .. |st.image| replace:: ``st.image``
         .. _st.image: https://docs.streamlit.io/develop/api-reference/media/st.image
 
-    layout: "centered" or "wide"
-        How the page content should be laid out. Defaults to "centered",
-        which constrains the elements into a centered column of fixed width;
-        "wide" uses the entire screen.
+    layout: "centered", "wide", or None
+        How the page content should be laid out. If this is ``None`` (default),
+        the page layout is inherited from the previous call of
+        ``st.set_page_config``. If this is ``None`` and no previous call
+        exists, the page layout is ``"centered"``.
+
+        ``"centered"`` constrains the elements into a centered column of fixed
+        width. ``"wide"`` uses the entire screen.
+
+    initial_sidebar_state: "auto", "expanded", "collapsed", or None
+        How the sidebar should start out. If this is ``None`` (default), the
+        sidebar state is inherited from the previous call of
+        ``st.set_page_config``. If no previous call exists, the sidebar state
+        is ``"auto"``.
+
+        The folowing states are supported:
+
+        - ``"auto"``: The sidebar is hidden on small devices and shown otherwise.
+        - ``"expanded"``: The sidebar is shown initially.
+        - ``"collapsed"``: The sidebar is hidden initially.
 
-    initial_sidebar_state: "auto", "expanded", or "collapsed"
-        How the sidebar should start out. Defaults to "auto",
-        which hides the sidebar on small devices and shows it otherwise.
-        "expanded" shows the sidebar initially; "collapsed" hides it.
-        In most cases, you should just use "auto", otherwise the app will
-        look bad when embedded and viewed on mobile.
+        In most cases, ``"auto"`` provides the best user experience across
+        devices of different sizes.
 
     menu_items: dict
         Configure the menu that appears on the top-right side of this app.
@@ -187,6 +207,8 @@ def set_page_config(
             If None, only shows Streamlit's default About text.
 
         The URL may also refer to an email address e.g. ``mailto:john@example.com``.
+        To remove an item that was specified in a previous call to
+        ``st.set_page_config``, set its value to ``None`` in the dictionary.
 
     Example
     -------
@@ -218,6 +240,9 @@ def set_page_config(
         pb_layout = PageConfigProto.CENTERED
     elif layout == "wide":
         pb_layout = PageConfigProto.WIDE
+    elif layout is None:
+        # Allows for multiple (additive) calls to set_page_config
+        pb_layout = PageConfigProto.LAYOUT_UNSET
     else:
         # Note: Pylance incorrectly notes this error as unreachable
         raise StreamlitInvalidPageLayoutError(layout=layout)
@@ -231,6 +256,9 @@ def set_page_config(
         pb_sidebar_state = PageConfigProto.EXPANDED
     elif initial_sidebar_state == "collapsed":
         pb_sidebar_state = PageConfigProto.COLLAPSED
+    elif initial_sidebar_state is None:
+        # Allows for multiple (additive) calls to set_page_config
+        pb_sidebar_state = PageConfigProto.SIDEBAR_UNSET
     else:
         # Note: Pylance incorrectly notes this error as unreachable
         raise StreamlitInvalidSidebarStateError(

streamlit/config.py

@@ -676,12 +676,11 @@ _create_section("server", "Settings for the Streamlit server")
 _create_option(
     "server.folderWatchList",
     description="""
-        List of folders to watch for changes.
+        List of directories to watch for changes.
 
-        By default, Streamlit watches for files in the current working directory.
-        Use this parameter to specify additional folders to watch.
-
-        Note: This is a list of absolute paths.
+        By default, Streamlit watches files in the current working directory
+        and its subdirectories. Use this option to specify additional
+        directories to watch. Paths must be absolute.
     """,
     default_val=[],
     multiple=True,
@@ -690,9 +689,12 @@ _create_option(
 _create_option(
     "server.folderWatchBlacklist",
     description="""
-        List of folders that should not be watched for changes.
+        List of directories to ignore for changes.
 
-        Relative paths will be taken as relative to the current working directory.
+        By default, Streamlit watches files in the current working directory
+        and its subdirectories. Use this option to specify exceptions within
+        watched directories. Paths can be absolute or relative to the current
+        working directory.
 
         Example: ['/home/user1/env', 'relative/path/to/folder']
     """,
@@ -840,9 +842,11 @@ _create_option(
 _create_option(
     "server.corsAllowedOrigins",
     description="""
-        If CORS protection is enabled (when server.enableCORS=True), allows an
-        app developer to set a list of allowed origins that the Streamlit server
-        will accept traffic from.
+        Allowed list of origins.
+
+        If CORS protection is enabled (`server.enableCORS=True`), use this
+        option to set a list of allowed origins that the Streamlit server will
+        accept traffic from.
 
         This config option does nothing if CORS protection is disabled.
 
@@ -1152,14 +1156,14 @@ _create_theme_options(
     "font",
     categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
-        The font family for all text, except code blocks. This can be one of
-        the following:
+        The font family for all text, except code blocks.
 
+        This can be one of the following:
         - "sans-serif"
         - "serif"
         - "monospace"
-        - the `family` value for a custom font table under [[theme.fontFaces]]
-        - a comma-separated list of these (as a single string) to specify
+        - The `family` value for a custom font table under [[theme.fontFaces]]
+        - A comma-separated list of these (as a single string) to specify
           fallbacks
 
         For example, you can use the following:
@@ -1172,29 +1176,43 @@ _create_theme_options(
     "codeFont",
     categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
-        The font family to use for code (monospace) in the sidebar. This can be
-        one of the following:
+        The font family to use for code (monospace) in the sidebar.
 
+        This can be one of the following:
         - "sans-serif"
         - "serif"
         - "monospace"
-        - the `family` value for a custom font table under [[theme.fontFaces]]
-        - a comma-separated list of these (as a single string) to specify
+        - The `family` value for a custom font table under [[theme.fontFaces]]
+        - A comma-separated list of these (as a single string) to specify
           fallbacks
     """,
 )
 
+_create_theme_options(
+    "codeFontSize",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
+    description="""
+        Sets the font size (in pixels or rem) for code blocks and code text.
+
+        This applies to code blocks (ex: `st.code`), as well as font in `st.json` and `st.help`.
+        It does not apply to inline code, which is set by default to 0.75em.
+
+        When unset, the code font size will be 0.875rem.
+    """,
+)
+
 _create_theme_options(
     "headingFont",
     categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
-        The font family to use for headings. This can be one of the following:
+        The font family to use for headings.
 
+        This can be one of the following:
         - "sans-serif"
         - "serif"
         - "monospace"
-        - the `family` value for a custom font table under [[theme.fontFaces]]
-        - a comma-separated list of these (as a single string) to specify
+        - The `family` value for a custom font table under [[theme.fontFaces]]
+        - A comma-separated list of these (as a single string) to specify
           fallbacks
 
         If no heading font is set, Streamlit uses `theme.font` for headings.
@@ -1207,21 +1225,27 @@ _create_theme_options(
     description="""
         An array of fonts to use in your app.
 
-        Each font in the array is a table (dictionary) with the following three
-        attributes: family, url, weight, and style.
+        Each font in the array is a table (dictionary) that can have the
+        following attributes, closely resembling CSS font-face definitions:
+        - family
+        - url
+        - weight (optional)
+        - style (optional)
+        - unicodeRange (optional)
 
         To host a font with your app, enable static file serving with
         `server.enableStaticServing=true`.
 
-        You can define multiple [[theme.fontFaces]] tables.
+        You can define multiple [[theme.fontFaces]] tables, including multiple
+        tables with the same family if your font is defined by multiple files.
 
-        For example, each font is defined in a [[theme.fontFaces]] table as
-        follows:
+        For example, a font hosted with your app may have a [[theme.fontFaces]]
+        table as follows:
 
             [[theme.fontFaces]]
             family = "font_name"
             url = "app/static/font_file.woff"
-            weight = 400
+            weight = "400"
             style = "normal"
     """,
 )
@@ -1238,9 +1262,10 @@ _create_theme_options(
         - "medium"
         - "large"
         - "full"
-        - ...or the number in pixels or rem. For example, you can use "10px",
-          "0.5rem", or "2rem". To follow best practices, use rem instead of
-          pixels when specifying a numeric size.
+        - The number in pixels or rem.
+
+        For example, you can use "10px", "0.5rem", or "2rem". To follow best
+        practices, use rem instead of pixels when specifying a numeric size.
     """,
 )
 
@@ -1256,9 +1281,12 @@ _create_theme_options(
         - "medium"
         - "large"
         - "full"
-        - ...or the number in pixels or rem. For example, you can use "10px",
-          "0.5rem", or "2rem". To follow best practices, use rem instead of
-          pixels when specifying a numeric size.
+        - The number in pixels or rem.
+
+        For example, you can use "10px", "0.5rem", or "2rem". To follow best
+        practices, use rem instead of pixels when specifying a numeric size.
+
+        If no button radius is set, Streamlit uses `theme.baseRadius` instead.
     """,
 )
 
@@ -1275,6 +1303,9 @@ _create_theme_options(
     categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
         The color of the border around dataframes and tables.
+
+        If no dataframe border color is set, Streamlit uses `theme.borderColor`
+        instead.
     """,
 )
 

streamlit/dataframe_util.py

@@ -41,7 +41,6 @@ from typing_extensions import TypeAlias, TypeGuard
 from streamlit import config, errors, logger, string_util
 from streamlit.type_util import (
     CustomDict,
-    NumpyShape,
     has_callable_attr,
     is_custom_dict,
     is_dataclass_instance,
@@ -924,7 +923,7 @@ def convert_anything_to_list(obj: OptionSequence[V_co]) -> list[V_co]:
 
     if isinstance(obj, (str, int, float, bool)):
         # Wrap basic objects into a list
-        return [obj]
+        return [obj]  # type: ignore[list-item]
 
     if isinstance(obj, EnumMeta):
         # Support for enum classes. For string enums, we return the string value
@@ -1167,7 +1166,7 @@ def determine_data_format(input_data: Any) -> DataFormat:
     if isinstance(input_data, pd.DataFrame):
         return DataFormat.PANDAS_DATAFRAME
     if isinstance(input_data, np.ndarray):
-        if len(cast("NumpyShape", input_data.shape)) == 1:
+        if len(input_data.shape) == 1:
             # For technical reasons, we need to distinguish one
             # one-dimensional numpy array from multidimensional ones.
             return DataFormat.NUMPY_LIST

streamlit/elements/alert.py

@@ -66,13 +66,15 @@ class AlertMixin:
               Thumb Up icon. Find additional icons in the `Material Symbols \
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
-        width : int or "stretch"
-            The desired width of the alert expressed in pixels. If this is
-            ``"stretch"`` (default), Streamlit sets the width of the alert to
-            match the width of the parent container. Otherwise, this must be an
-            integer. If the specified width is greater than the width of the
-            parent container, Streamlit sets the width of the alert to match
-            the width of the parent container.
+        width : "stretch" or int
+            The width of the alert element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
 
         Example
         -------
@@ -137,13 +139,15 @@ class AlertMixin:
               Thumb Up icon. Find additional icons in the `Material Symbols \
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
-        width : int or "stretch"
-            The desired width of the alert expressed in pixels. If this is
-            ``"stretch"`` (default), Streamlit sets the width of the alert to
-            match the width of the parent container. Otherwise, this must be an
-            integer. If the specified width is greater than the width of the
-            parent container, Streamlit sets the width of the alert to match
-            the width of the parent container.
+        width : "stretch" or int
+            The width of the warning element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
 
         Example
         -------
@@ -207,13 +211,15 @@ class AlertMixin:
               Thumb Up icon. Find additional icons in the `Material Symbols \
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
-        width : int or "stretch"
-            The desired width of the alert expressed in pixels. If this is
-            ``"stretch"`` (default), Streamlit sets the width of the alert to
-            match the width of the parent container. Otherwise, this must be an
-            integer. If the specified width is greater than the width of the
-            parent container, Streamlit sets the width of the alert to match
-            the width of the parent container.
+        width : "stretch" or int
+            The width of the info element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
 
         Example
         -------
@@ -278,13 +284,15 @@ class AlertMixin:
               Thumb Up icon. Find additional icons in the `Material Symbols \
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
-        width : int or "stretch"
-            The desired width of the alert expressed in pixels. If this is
-            ``"stretch"`` (default), Streamlit sets the width of the alert to
-            match the width of the parent container. Otherwise, this must be an
-            integer. If the specified width is greater than the width of the
-            parent container, Streamlit sets the width of the alert to match
-            the width of the parent container.
+        width : "stretch" or int
+            The width of the success element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
 
         Example
         -------

streamlit/elements/arrow.py

@@ -645,7 +645,7 @@ class ArrowMixin:
                 value_type="string_value",
             )
             self.dg._enqueue("arrow_data_frame", proto)
-            return cast("DataframeState", widget_state.value)
+            return widget_state.value
         return self.dg._enqueue("arrow_data_frame", proto)
 
     @gather_metrics("table")

streamlit/elements/code.py

@@ -68,16 +68,31 @@ class CodeMixin:
             An optional boolean indicating whether to wrap lines. This defaults
             to ``False``.
 
-        height : int or None
-            Desired height of the code block expressed in pixels. If ``height``
-            is ``None`` (default), Streamlit sets the element's height to fit
-            its content. Vertical scrolling within the element is enabled when
-            the height does not accommodate all lines.
+        height : "content" or int
+            The height of the code block element. This can be one of the following:
+
+            - ``"content"`` (default): The height of the element matches the
+              height of its content.
+            - An integer specifying the height in pixels: The element has a
+              fixed height. If the content is larger than the specified
+              height, scrolling is enabled.
+
+            .. note::
+                Use scrolling containers sparingly. If you use scrolling
+                containers, avoid heights that exceed 500 pixels. Otherwise,
+                the scroll surface of the container might cover the majority of
+                the screen on mobile devices, which makes it hard to scroll the
+                rest of the app.
 
         width : "stretch" or int
-            The width of the code block. This can be either:
-            - "stretch" (default): The code block will stretch to fill the container width
-            - An integer: The code block will have a fixed width in pixels
+            The width of the code block element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
 
         Examples
         --------

streamlit/elements/deck_gl_json_chart.py

@@ -529,7 +529,7 @@ class PydeckMixin:
 
             self.dg._enqueue("deck_gl_json_chart", pydeck_proto)
 
-            return cast("PydeckState", widget_state.value)
+            return widget_state.value
 
         return self.dg._enqueue("deck_gl_json_chart", pydeck_proto)
 

streamlit/elements/doc_string.py

@@ -59,8 +59,14 @@ class HelpMixin:
             The object whose information should be displayed. If left
             unspecified, this call will display help for Streamlit itself.
         width : "stretch" or int
-            The width of the help element. Can be "stretch" to fill the container
-            width, or an integer to specify a fixed width in pixels.
+            The width of the help element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
 
         Example
         -------

streamlit/elements/exception.py

@@ -60,13 +60,15 @@ class ExceptionMixin:
         ----------
         exception : Exception
             The exception to display.
-        width : int or "stretch"
-            The desired width of the exception expressed in pixels. If this is
-            ``"stretch"`` (default), Streamlit sets the width of the exception
-            to match the width of the parent container. Otherwise, this must be
-            an integer. If the specified width is greater than the width of the
-            parent container, Streamlit sets the width of the exception to
-            match the width of the parent container.
+        width : "stretch" or int
+            The width of the exception element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
 
         Example
         -------

streamlit/elements/form.py

@@ -131,6 +131,34 @@ class FormMixin:
                 there's another border (e.g. because of an expander) or the form is small
                 (e.g. just a text input and a submit button).
 
+        width : "stretch", "content", or int
+            The width of the form container. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the container matches the
+              width of the parent container.
+            - ``"content"``: The width of the container matches the width of its
+              content, but doesn't exceed the width of the parent container.
+            - An integer specifying the width in pixels: The container has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the container matches the width
+              of the parent container.
+
+        height : "content" or int
+            The height of the form container. This can be one of the following:
+
+            - ``"content"`` (default): The height of the container matches the
+              height of its content.
+            - An integer specifying the height in pixels: The container has a
+              fixed height. If the content is larger than the specified
+              height, scrolling is enabled.
+
+            .. note::
+                Use scrolling containers sparingly. If you use scrolling
+                containers, avoid heights that exceed 500 pixels. Otherwise,
+                the scroll surface of the container might cover the majority of
+                the screen on mobile devices, which makes it hard to scroll the
+                rest of the app.
+
         Examples
         --------
         Inserting elements using ``with`` notation: