/_iV,bddlmZddlZddlZddlmZmZddlmZddl m Z ddl m Z m Z mZddlZddlmZmZddlmZmZdd lmZdd lmZdd lmZmZmZe rdd lm Z m!Z!ed ddZ" ddZ# ddZ$eddd ddZ%eddd ddZ&y)) annotationsN)IterableMapping) dropwhile)Path) TYPE_CHECKINGLiteralNoReturn)NoSessionContextStreamlitAPIException)get_main_script_directorynormalize_path_join) StreamlitPage)gather_metrics) RerunDataScriptRunContextget_script_run_ctx) QueryParamsQueryParamsInputstopct}|r<|jr/|jjtjyyy)aStops execution immediately. Streamlit will not run any statements after `st.stop()`. We recommend rendering a message to explain why the script has stopped. Example ------- >>> import streamlit as st >>> >>> name = st.text_input("Name") >>> if not name: >>> st.warning('Please input a name.') >>> st.stop() >>> st.success("Thank you for inputting a name.") N)rscript_requests request_stopstempty)ctxs c/var/www/html/land_sniper/venv/lib/python3.12/site-packages/streamlit/commands/execution_control.pyrr's9$  C s"" ((*  #sc|dk(rgSj}|s tdttfd|}|s t d|S)Nappzfscope="fragment" can only be specified from `@st.fragment`-decorated functions during fragment reruns.c"|jk7S)N)current_fragment_id)xrs rz(_new_fragment_id_queue..bsc.E.E)ErzRCould not find current_fragment_id in fragment_id_queue. This should never happen.)fragment_ids_this_runr listr RuntimeError)rscope curr_queue new_queues` r_new_fragment_id_queuer+Asd ~ **J& # 0  YEzRSI  `   rc||jyt|ts&t|tr(t|tt fs|j |ytdt|d)z#Set query params for a switch page.NzM`query_params` must be a mapping or an iterable of (key, value) pairs not a `z`.) clear isinstancerrstrbytes from_dictr type)query_params_statenew_query_paramss r_set_query_params_for_switchr5ksw   ""G,#X.  %L $$%56  WX\]mXnWooqr rrerunr )r(c P|dvrtd|dt}|r|jrz|j}|j}|j }|jj t||t|||dk(||jtjyyy)aRerun the script immediately. When ``st.rerun()`` is called, Streamlit halts the current script run and executes no further statements. Streamlit immediately queues the script to rerun. When using ``st.rerun`` in a fragment, you can scope the rerun to the fragment. However, if a fragment is running as part of a full-app rerun, a fragment-scoped rerun is not allowed. Parameters ---------- scope : "app" or "fragment" Specifies what part of the app should rerun. If ``scope`` is ``"app"`` (default), the full app reruns. If ``scope`` is ``"fragment"``, Streamlit only reruns the fragment from which this command is called. Setting ``scope="fragment"`` is only valid inside a fragment during a fragment rerun. If ``st.rerun(scope="fragment")`` is called during a full-app rerun or outside of a fragment, Streamlit will raise a ``StreamlitAPIException``. )r fragment'zC'is not a valid rerun scope. Valid scopes are 'app' and 'fragment'.r8) query_stringpage_script_hashfragment_id_queueis_fragment_scoped_reruncached_message_hashes context_infoN) r rrr:r;r> request_rerunrr+r?rr)r(rr:r;r>s rr6r6s: ''#wY Z    C s""'' // # 9 9 )) )!1"8e"D).*)<&; --     !#sr switch_page) query_paramsct}|r |js td}t|tr |j }nt|t r t|}t|j}tjjt||}|jjj!}|Dcgc] }|d|k(s |}}t#|dk(r/t%d|dtjj'|d|dd}|j(j+5} t-| |t/j0dd d d |jj3t5|j6||j8|j: t=j>y cc}w#1swYixYw) uu Programmatically switch the current page in a multipage app. When ``st.switch_page`` is called, the current page execution stops and the specified page runs as if the user clicked on it in the sidebar navigation. The specified page must be recognized by Streamlit's multipage architecture (your main Python file or a Python file in a ``pages/`` folder). Arbitrary Python scripts cannot be passed to ``st.switch_page``. Parameters ---------- page : str, Path, or st.Page The file path (relative to the main script) or an st.Page indicating the page to switch to. query_params : dict, list of tuples, or None Query parameters to apply when navigating to the target page. This can be a dictionary or an iterable of key-value tuples. Values can be strings or iterables of strings (for repeated keys). When this is ``None`` (default), all non-embed query parameters are cleared during navigation. Examples -------- **Example 1: Basic usage** The following example shows how to switch to a different page in a multipage app that uses the ``pages/`` directory: .. code-block:: text your-repository/ ├── pages/ │ ├── page_1.py │ └── page_2.py └── your_app.py >>> import streamlit as st >>> >>> if st.button("Home"): >>> st.switch_page("your_app.py") >>> if st.button("Page 1"): >>> st.switch_page("pages/page_1.py") >>> if st.button("Page 2"): >>> st.switch_page("pages/page_2.py") .. output:: https://doc-switch-page.streamlit.app/ height: 350px **Example 2: Passing query parameters** The following example shows how to pass query parameters when switching to a different page. This example uses ``st.navigation`` to create a multipage app. .. code-block:: text your-repository/ ├── page_2.py └── your_app.py >>> import streamlit as st >>> >>> def page_1(): >>> st.title("Page 1") >>> if st.button("Switch to Page 2"): >>> st.switch_page("page_2.py", query_params={"utm_source": "page_1"}) >>> >>> pg = st.navigation([page_1, "page_2.py"]) >>> pg.run() .. output:: https://doc-switch-page-query-params.streamlit.app/ height: 350px script_pathrzCould not find page: `zK`. Must be the file path relative to the main script, from the directory: `zL`. Only the main app file and files in the `pages/` directory are supported.r;g{Gz?N)r:r;r>r?) rrr r.r _script_hashrr/r main_script_pathospathrealpathr pages_manager get_pagesvalueslenr basename session_staterBr5timesleepr@rr:r>r?rr) pagerBrr;main_script_directoryrequested_page all_app_pagesp matched_pagesqps rrArAsd  C c))  $ &,, dD !t9D 9#:N:N O))  5t < ))335<<> $1XqQ}5E5WX X }  "'(/((*(8(89N(O'PQEE  )+,>?   ' ' )R$R6 4 %%))-"%";";))  HHJ;Ys F?F?:"GG )returnr )rrr(Literal['app', 'fragment']rZz list[str])r3rr4QueryParamsInput | NonerZNone)r(r[rZr )rSzstr | Path | StreamlitPagerBr\rZr )' __future__rrHrQcollections.abcrr itertoolsrpathlibrtypingrr r streamlitrstreamlit.errorsr r streamlit.file_utilr rstreamlit.navigation.pagerstreamlit.runtime.metrics_utilrstreamlit.runtime.scriptrunnerrrr$streamlit.runtime.state.query_paramsrrrr+r5r6rArrrks# -33DN39 R2' ' %''T#- 2).3 %333l -1B $B*B BBr