EiTMddlmZddlZddlZddlmZddlmZmZddl m Z m Z ddl m Z ddlmZddlmZdd lmZdd lmZdd lmZdd Zerdd lmZe ddddddd ddZGddZy)) annotationsN)Path) TYPE_CHECKINGLiteral)StreamlitAPIExceptionStreamlitValueError)gather_metrics)get_script_run_ctx)page_icon_and_name)validate_icon_or_emoji)is_url) calc_hashctjdd|j}tjdd|}|jd}tjdd|}|S)zSanitize a title string to be used as a URL path. Converts the title to lowercase, replaces whitespace with underscores, and removes special characters that are not URL-safe. z\s+_z[&#?/\\:*\"<>|']z_+)resublowerstrip)titlepaths [/var/www/pod-logistic/pod-ai/venv/lib/python3.12/site-packages/streamlit/navigation/page.py_sanitize_url_pathrsS 66&#u{{} -D 66%r4 0D ::c?D 66%d #D K)CallablePageFvisiblericonurl_pathdefault visibility StreamlitPagec$t||||||S)u0Configure a page for ``st.navigation`` in a multipage app. Call ``st.Page`` to initialize a ``StreamlitPage`` object, and pass it to ``st.navigation`` to declare a page in your app. When a user navigates to a page, ``st.navigation`` returns the selected ``StreamlitPage`` object. Call ``.run()`` on the returned ``StreamlitPage`` object to execute the page. You can only run the page returned by ``st.navigation``, and you can only run it once per app rerun. A page can be defined by a Python file, ``Callable``, or external URL. Parameters ---------- page : str, Path, or callable The source for the internal or external page. This can be one of the following values: - ``callable``: Streamlit executes the callable when it runs the page. The ``callable`` can't accept arguments. - Path to a Python file: Streamlit executes the Python script when it runs the page. The path can be a string or ``pathlib.Path`` object. It can be absolute or relative to the entrypoint file. - URL: Streamlit opens the URL in a new tab when a user selects it in the navigation menu or a page link. In this case, the app doesn't rerun. The URL must contain an HTTP or HTTPS scheme, like ``"https://docs.streamlit.io"``. If the page is defined by a URL, then the ``title`` parameter is required. title : str or None The title of the page. If this is ``None`` (default), the page title (in the browser tab) and label (in the navigation menu) will be inferred from the filename or callable name in ``page``. For more information, see `Overview of multipage apps `_. The title supports GitHub-flavored Markdown of the following types: Bold, Italics, Strikethrough, Inline Code, 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. Common block-level Markdown (headings, lists, blockquotes) is automatically escaped and displays as literal text in labels. 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 icon : str or None An optional emoji or icon to display next to the page title and label. If ``icon`` is ``None`` (default), no icon is displayed next to the page label in the navigation menu, and a Streamlit icon is displayed next to the title (in the browser tab). If ``icon`` is a string, the following options are valid: - A single-character emoji. For example, you can set ``icon="🚨"`` or ``icon="🔥"``. Emoji short codes are not supported. - An icon from the Material Symbols library (rounded style) in the format ``":material/icon_name:"`` where "icon_name" is the name of the icon in snake case. For example, ``icon=":material/thumb_up:"`` will display the Thumb Up icon. Find additional icons in the `Material Symbols `_ font library. - ``"spinner"``: Displays a spinner as an icon. In this case, the spinner only displays next to the page label in the navigation menu. The spinner isn't used as the page favicon next to the title in the browser tab. The favicon is the default Streamlit icon unless otherwise specified with the ``page_icon`` parameter of ``st.set_page_config``. url_path : str or None The page's URL pathname, which is the path relative to the app's root URL. If this is ``None`` (default), the URL pathname will be inferred from the filename or callable name in ``page``. For more information, see `Overview of multipage apps `_. The default page will have a pathname of ``""``, indicating the root URL of the app. If you set ``default=True``, ``url_path`` is ignored. ``url_path`` can't include forward slashes; paths can't include subdirectories. default : bool Whether this page is the default page to be shown when the app is loaded. If ``default`` is ``False`` (default), the page will have a nonempty URL pathname. However, if no default page is passed to ``st.navigation`` and this is the first page, this page will become the default page. If ``default`` is ``True``, then the page will have an empty pathname and ``url_path`` will be ignored. visibility : "visible" or "hidden" Whether the page is shown in the navigation menu. If this is ``"visible"`` (default), the page appears in the navigation menu. If this is ``"hidden"``, the page is excluded from the navigation menu. Hidden pages defined by Python files or callables remain accessible by ``st.page_link`` and ``st.switch_page``. External URLs can always be accessed using ``st.page_link`` regardless of their inclusion or visibility in the navigation menu. .. note:: Navigating to an internal page by URL starts a new session. For any internal page to be accessible by URL, it must be passed to ``st.navigation`` during the new session's initial script run. The page can be visible or hidden. Returns ------- StreamlitPage The page object associated to the given script. Example ------- .. code-block:: python :filename: streamlit_app.py import streamlit as st def page2(): st.title("Second page") pg = st.navigation([ st.Page("page1.py", title="First page", icon="🔥"), st.Page(page2, title="Second page", icon=":material/favorite:"), st.Page( "https://docs.streamlit.io", title="Streamlit Docs", icon=":material/open_in_new:" ), ]) pg.run() r)r#)pagerrr r!r"s rrr4s$j     rceZdZdZdddddd ddZeddZeddZedd Zedd Z edd Z edd Z dd Z eddZ y)r#aA page within a multipage Streamlit app. Use ``st.Page`` to initialize a ``StreamlitPage`` object. Attributes ---------- icon : str The icon of the page. If no icon was declared in ``st.Page``, this property returns ``""``. title : str The title of the page. Unless declared otherwise in ``st.Page``, the page title is inferred from the filename or callable name. For more information, see `Overview of multipage apps `_. The title supports GitHub-flavored Markdown as described in ``st.Page``. url_path : str The page's URL pathname, which is the path relative to the app's root URL. Unless declared otherwise in ``st.Page``, the URL pathname is inferred from the filename or callable name. For more information, see `Overview of multipage apps `_. The default page will always have a ``url_path`` of ``""`` to indicate the root URL (e.g. homepage). visibility : Literal["visible", "hidden"] Whether the page is shown in the navigation menu. If this is ``"visible"`` (default), the page appears in the navigation menu. If this is ``"hidden"``, the page is excluded from the navigation menu. For internal pages, hidden pages remain accessible via direct URL, ``st.page_link``, or ``st.switch_page``. For external URL pages, hidden pages are not URL-accessible or switchable via ``st.switch_page``; they can still be linked with ``st.page_link``. .. note:: Navigating to an internal page by URL starts a new session. For a hidden page to be accessible by URL, it must be passed to ``st.navigation`` during the new session's initial script run. NFrrc||_d|_|dvrtdddg||_t }|syt |t rt|r|td||jdk(rtd||r td||_d|_ ||_ | t||xsd|_ | t|n||_|jjjd |_|jdk(r td d |jvr td d |_y|j"j$}t |t r t'|}t |t&r<||z j)}|j+std |j,dd} d} t |t&rt/|\} } n/t1|drt |j2} n | td||_ |xs| j5dd|_ | t||xs| |_ |jjdk(r td| |_|a|j} | jd } | jdk(r |s td| |_d |jvr td |jrt|jd |_y)N>hiddenrr"rr(zTExternal URL pages require a `title` parameter. Please provide a title for the URL: rz^External URL pages require a non-empty `title` parameter. Please provide a title for the URL: z5External URL pages cannot be set as the default page./zwThe URL path cannot be empty. Please provide a valid `url_path` or a `title` that can be converted to a valid URL path.z9The URL path cannot contain a nested path (e.g. foo/bar).Fz!Unable to create Page. The file `z` could not be found.__name__zHCannot infer page title for Callable. Set the `title=` keyword argument.r zKThe title of the page cannot be empty or consist of underscores/spaces onlyzKThe URL path cannot be an empty string unless the page is the default page.)_default _external_urlr _visibilityr isinstancestrr rr_page_titler _iconr _url_path_can_be_called pages_managermain_script_parentrresolveis_filenamer hasattrr*replace) selfr%rrr r!r"ctx main_path inferred_name inferred_iconurl_path_trimmedstripped_url_paths r__init__zStreamlitPage.__init__s"& )- 2 2%lY4IJ J9C "  dC VD\}+;;?&B{{}"+;;?&B+K"&D ;?DJ$DK&t,"jbDJ.6-="5)8 N "^^11399#>DN~~#+Ndnn$+O).D  %%88 dC :D dD !$--/D<<>+7 {BWX  dD !+=d+C (M= T: & .M ] (Z  >}44S#>   "4 (*] ;;   " $'] '  '~~/  0 6 6s ;  &&(B.w+a/DNdnn$+O :: "4:: .$rc|jS)anThe title of the page. Unless declared otherwise in ``st.Page``, the page title is inferred from the filename or callable name. For more information, see `Overview of multipage apps `_. The title supports GitHub-flavored Markdown as described in ``st.Page``. )r2r=s rrzStreamlitPage.titles{{rc|jS)zmThe icon of the page. If no icon was declared in ``st.Page``, this property returns ``""``. )r3rFs rrzStreamlitPage.icons zzrc6|jrdS|jS)aThe page's URL pathname, which is the path relative to the app's root URL. Unless declared otherwise in ``st.Page``, the URL pathname is inferred from the filename or callable name. For more information, see `Overview of multipage apps `_. The default page will always have a ``url_path`` of ``""`` to indicate the root URL (e.g. homepage). r)r,r4rFs rr zStreamlitPage.url_paths]]r66rc|jS)aThe visibility of the page in the navigation menu. This property returns ``"visible"`` (default) or ``"hidden"``. Hidden internal pages are not shown in the navigation menu but can still be accessed via URL or programmatically using ``st.switch_page`` or ``st.page_link``. Hidden external pages can only be opened via ``st.page_link``. )r.rFs rr"zStreamlitPage.visibilitysrc|jduS)zWhether this page is an external URL. If ``True``, clicking this page in the navigation menu will open the external URL in a new browser tab instead of navigating within the app. Nr-rFs r is_externalzStreamlitPage.is_externals!!--rc|jS)zThe external URL of the page, if this is an external link. Returns ``None`` if this is not an external URL page. rKrFs r external_urlzStreamlitPage.external_urls !!!rcJ|js tdd|_|jryt}|sy|j |j 5t |jtr|jjt|j}tjd}t|j|jd<t||j dddy|j|jdddy#1swYyxYw)aExecute the page. When a page is returned by ``st.navigation``, use the ``.run()`` method within your entrypoint file to render the page. You can only call this method on the page returned by ``st.navigation``. You can only call this method once per run of your entrypoint file. For external URL pages, this method does nothing as the navigation to the external URL is handled by the frontend. zbThis page cannot be called directly. Only the page returned from st.navigation can be called once.FN__main____file__)r5rrLr run_with_active_hash _script_hashr/r1rr6get_page_script_byte_coder0types ModuleType__dict__exec)r=r>codemodules rrunzStreamlitPage.runs""'t $     "   % %d&7&7 8 $**d+((BB3tzz?S))*5.1$**o +T6??+  zz%    sBD4DD"c,t|jS)N)rr4rFs rrSzStreamlitPage._script_hashs((r)r%str | Path | Callable[[], None]r str | Nonerr^r r^r!boolr"Literal['visible', 'hidden']returnNone)rar0)rar`)rar_)rar^)rarb)r* __module__ __qualname____doc__rDpropertyrrr r"rLrNr[rSrrr#r#s2p!#3<}$-}$ }$  }$  }$}$1}$ }$~   7 7    ..""%N))r)rr0rar0)r%r]rr^rr^r r^r!r_r"r`rar#) __future__rrrUpathlibrtypingrrstreamlit.errorsrrstreamlit.runtime.metrics_utilr 7streamlit.runtime.scriptrunner_utils.script_run_contextr streamlit.source_utilr streamlit.string_utilr streamlit.url_utilr streamlit.utilrrcollections.abcrrr#rgrrrss# )G9V48%$"(/8[ )[ [  [  [  [-[[[|_)_)r