g.ddlmZddlZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZe d dddd d  ddZGddZy)) annotationsN)Path)Callable)StreamlitAPIException)gather_metrics)get_script_run_ctx)page_icon_and_name)validate_icon_or_emoji)calc_md5PageFtitleiconurl_pathdefaultc"t|||||S)uSConfigure 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 or ``Callable``. Python files used as a ``StreamlitPage`` source will have ``__name__ == "__page__"``. Functions used as a ``StreamlitPage`` source will have ``__name__`` corresponding to the module they were imported from. Only the entrypoint file and functions defined within the entrypoint file have ``__name__ == "__main__"`` to adhere to Python convention. Parameters ---------- page : str, Path, or callable The page source as a ``Callable`` or path to a Python file. If the page source is defined by a Python file, the path can be a string or ``pathlib.Path`` object. Paths can be absolute or relative to the entrypoint file. If the page source is defined by a ``Callable``, the ``Callable`` can't accept arguments. 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 `_. 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. 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. Returns ------- StreamlitPage The page object associated to the given script. Example ------- >>> 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:"), >>> ]) >>> pg.run() r ) StreamlitPage)pagerrrrs N/var/www/openai/venv/lib/python3.12/site-packages/streamlit/navigation/page.pyr r sH  Ex ceZdZdZddddd d dZed dZed dZed dZd d Z ed d Z y)raA 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 `_. 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). NFr ct||_t}|sy|jj}t |t r t |}t |t r<||z j}|jstd|jdd}d} t |t rt|\} }n/t|drt |j}n | td||_|xs|jdd|_|xs| |_|j j%dk(r td||_|O|j%dk(r |s td |j%d |_d |j&vr td |j"rt)|j"d |_y) Nz!Unable to create Page. The file `z` could not be found.__name__zHCannot infer page title for Callable. Set the `title=` keyword argument._ 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./z9The URL path cannot contain a nested path (e.g. foo/bar).F)_defaultr pages_managermain_script_parent isinstancestrrresolveis_filernamer hasattrr_pagereplace_title_iconstrip _url_pathr _can_be_called) selfrrrrrctx main_path inferred_name inferred_icons r__init__zStreamlitPage.__init__s&  " %%88 dC :D dD !$--/D<<>+7 {BWX  dD !+=d+C (M= T: & .M ] (Z 15  CM$9$9#s$C /- ;;   " $'] ,  ~~2%g+a&^^C0DNdnn$+O :: "4:: .%*rc|jS)aThe 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 `_. )r)r.s rrzStreamlitPage.titles{{rc|jS)zmThe icon of the page. If no icon was declared in ``st.Page``, this property returns ``""``. )r*r5s 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)rr,r5s rrzStreamlitPage.url_paths]]r66rc|js tdd|_t}|sy|j|j5t |j r|j  dddy|jjt|j }tjd}|j |jd<t||j dddy#1swYyxYw)aAExecute 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. zbThis page cannot be called directly. Only the page returned from st.navigation can be called once.FN__page____file__)r-rrrun_with_active_hash _script_hashcallabler'rget_page_script_byte_coder"types ModuleType__dict__exec)r.r/codemodules rrunzStreamlitPage.runs""'t $ "   % %d&7&7 8 # 9 8 ((BB3tzz?S))*5.2jj +T6??+9 8 8s'C37A2C33C<c,t|jS)N)r r,r5s rr<zStreamlitPage._script_hash4s''r rzstr | Path | Callable[[], None]r str | NonerrHrrHrbool)returnr")rJNone) r __module__ __qualname____doc__r3propertyrrrrEr<rrrrsJ!#F*-F* F*  F*  F*F*P 7 7 ,D((rrrG) __future__rr?pathlibrtypingrstreamlit.errorsrstreamlit.runtime.metrics_utilr7streamlit.runtime.scriptrunner_utils.script_run_contextrstreamlit.source_utilr streamlit.string_utilr streamlit.utilr r rrPrrrZs# 29V48# e )e e  e  e  eePp(p(r