streamlit-nightly 1.39.1.dev20241031__py2.py3-none-any.whl → 1.39.1.dev20241102__py2.py3-none-any.whl

streamlit/commands/execution_control.py

@@ -16,6 +16,7 @@ from __future__ import annotations
 
 import os
 from itertools import dropwhile
+from pathlib import Path
 from typing import Literal, NoReturn
 
 import streamlit as st
@@ -146,7 +147,7 @@ def rerun(  # type: ignore[misc]
 
 
 @gather_metrics("switch_page")
-def switch_page(page: str | StreamlitPage) -> NoReturn:  # type: ignore[misc]
+def switch_page(page: str | Path | StreamlitPage) -> NoReturn:  # type: ignore[misc]
     """Programmatically switch the current page in a multipage app.
 
     When ``st.switch_page`` is called, the current page execution stops and
@@ -157,7 +158,7 @@ def switch_page(page: str | StreamlitPage) -> NoReturn:  # type: ignore[misc]
 
     Parameters
     ----------
-    page: str or st.Page
+    page: str, Path, or st.Page
         The file path (relative to the main script) or an st.Page indicating
         the page to switch to.
 
@@ -197,6 +198,10 @@ def switch_page(page: str | StreamlitPage) -> NoReturn:  # type: ignore[misc]
     if isinstance(page, StreamlitPage):
         page_script_hash = page._script_hash
     else:
+        # Convert Path to string if necessary
+        if isinstance(page, Path):
+            page = str(page)
+
         main_script_directory = get_main_script_directory(ctx.main_script_path)
         requested_page = os.path.realpath(
             normalize_path_join(main_script_directory, page)

streamlit/commands/logo.py

@@ -19,7 +19,7 @@ from __future__ import annotations
 from typing import Literal
 
 from streamlit import url_util
-from streamlit.elements.image import AtomicImage, WidthBehaviour, image_to_url
+from streamlit.elements.lib.image_utils import AtomicImage, WidthBehavior, image_to_url
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.ForwardMsg_pb2 import ForwardMsg
 from streamlit.runtime.metrics_util import gather_metrics
@@ -132,7 +132,7 @@ def logo(
     try:
         image_url = image_to_url(
             image,
-            width=WidthBehaviour.AUTO,
+            width=WidthBehavior.AUTO,
             clamp=False,
             channels="RGB",
             output_format="auto",
@@ -155,7 +155,7 @@ def logo(
         try:
             icon_image_url = image_to_url(
                 icon_image,
-                width=WidthBehaviour.AUTO,
+                width=WidthBehavior.AUTO,
                 clamp=False,
                 channels="RGB",
                 output_format="auto",

streamlit/commands/navigation.py

@@ -126,15 +126,47 @@ def navigation(
     you pass to ``streamlit run``. Your entrypoint file manages your app's
     navigation and serves as a router between pages.
 
+    **Example 1: Use a callable or Python file as a page**
+
     You can declare pages from callables or file paths.
 
+    ``page_1.py`` (in the same directory as your entrypoint file):
+
+    >>> import streamlit as st
+    >>>
+    >>> st.title("Page 1")
+
+    Your entrypoint file:
+
     >>> import streamlit as st
-    >>> from page_functions import page1
     >>>
-    >>> pg = st.navigation([st.Page(page1), st.Page("page2.py")])
+    >>> def page_2():
+    ...     st.title("Page 2")
+    >>>
+    >>> pg = st.navigation([st.Page("page_1.py"), st.Page(page_2)])
     >>> pg.run()
 
-    Use a dictionary to create sections within your navigation menu.
+    .. output::
+        https://doc-navigation-example-1.streamlit.app/
+        height: 200px
+
+    **Example 2: Group pages into sections**
+
+    You can use a dictionary to create sections within your navigation menu. In
+    the following example, each page is similar to Page 1 in Example 1, and all
+    pages are in the same directory. However, you can use Python files from
+    anywhere in your repository. For more information, see |st.Page|_.
+
+    Directory structure:
+
+    >>> your_repository/
+    >>> ├── create_account.py
+    >>> ├── learn.py
+    >>> ├── manage_account.py
+    >>> ├── streamlit_app.py
+    >>> └── trial.py
+
+    ``streamlit_app.py``:
 
     >>> import streamlit as st
     >>>
@@ -152,6 +184,12 @@ def navigation(
     >>> pg = st.navigation(pages)
     >>> pg.run()
 
+    .. output::
+        https://doc-navigation-example-2.streamlit.app/
+        height: 300px
+
+    **Example 3: 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
     values through Session State within your pages.
@@ -171,6 +209,13 @@ def navigation(
     >>> pg = st.navigation([st.Page(page1), st.Page(page2)])
     >>> pg.run()
 
+    .. output::
+        https://doc-navigation-multipage-widgets.streamlit.app/
+        height: 350px
+
+    .. |st.Page| replace:: ``st.Page``
+    .. _st.Page: https://docs.streamlit.io/develop/api-reference/navigation/st.page
+
     """
     nav_sections = {"": pages} if isinstance(pages, list) else pages
     page_list = pages_from_nav_sections(nav_sections)

streamlit/commands/page_config.py

@@ -15,12 +15,13 @@
 from __future__ import annotations
 
 import random
+from pathlib import Path
 from textwrap import dedent
 from typing import TYPE_CHECKING, Any, Final, Literal, Mapping, Union, cast
 
 from typing_extensions import TypeAlias
 
-from streamlit.elements import image
+from streamlit.elements.lib.image_utils import AtomicImage, image_to_url
 from streamlit.errors import (
     StreamlitInvalidMenuItemKeyError,
     StreamlitInvalidPageLayoutError,
@@ -41,7 +42,7 @@ GET_HELP_KEY: Final = "get help"
 REPORT_A_BUG_KEY: Final = "report a bug"
 ABOUT_KEY: Final = "about"
 
-PageIcon: TypeAlias = Union[image.AtomicImage, str]
+PageIcon: TypeAlias = Union[AtomicImage, str]
 Layout: TypeAlias = Literal["centered", "wide"]
 InitialSideBarState: TypeAlias = Literal["auto", "expanded", "collapsed"]
 _GetHelp: TypeAlias = Literal["Get help", "Get Help", "get help"]
@@ -105,9 +106,13 @@ def _get_favicon_string(page_icon: PageIcon) -> str:
     if isinstance(page_icon, str) and page_icon.startswith(":material"):
         return validate_material_icon(page_icon)
 
+    # Convert Path to string if necessary
+    if isinstance(page_icon, Path):
+        page_icon = str(page_icon)
+
     # Fall back to image_to_url.
     try:
-        return image.image_to_url(
+        return image_to_url(
             page_icon,
             width=-1,  # Always use full width for favicons
             clamp=False,

streamlit/elements/html.py

@@ -15,6 +15,7 @@
 from __future__ import annotations
 
 import os
+from pathlib import Path
 from typing import TYPE_CHECKING, cast
 
 from streamlit.proto.Html_pb2 import Html as HtmlProto
@@ -29,7 +30,7 @@ class HtmlMixin:
     @gather_metrics("html")
     def html(
         self,
-        body: str,
+        body: str | Path,
     ) -> DeltaGenerator:
         """Insert HTML into your app.
 
@@ -45,7 +46,7 @@ class HtmlMixin:
 
         Parameters
         ----------
-        body : str
+        body : str, Path
             The HTML code to insert, or path to an HTML code file which is
             loaded and inserted.
 
@@ -67,8 +68,9 @@ class HtmlMixin:
 
         """
         html_proto = HtmlProto()
-        # Check if the body is a file path
-        if os.path.isfile(body):
+
+        # Check if the body is a file path. If it's a Path object, open it directly.
+        if os.path.isfile(body) or isinstance(body, Path):
             with open(body, encoding="utf-8") as f:
                 html_proto.body = f.read()
         else: