o 沪g1@sUddlmZddlZddlZddlmZddlmZddlm Z ddl m Z m Z m Z mZmZmZmZddlmZddlmZdd lmZmZdd lmZdd lmZmZmZmZdd l m!Z!m"Z"m#Z#dd l$m%Z%m&Z&ddl'm(Z(ddl)m*Z+ddl,m-Z.ddl/m0Z1ddl2m3Z4ddl5m6Z6ddl7m8Z8m9Z9ddl:m;Z;mZ>ddl?m@Z@ddlAmBZBe rddlCmDZDdZEdeFd<eeGeHee ejIfZJdeFd<eGdddZKGd d!d!ZL d.d/d,d-ZMdS)0) annotationsN) dataclass)Path)dedent) TYPE_CHECKINGBinaryIOFinalLiteralTextIOUnioncast) TypeAlias)runtime)current_form_id is_in_form)check_widget_policies)Keycompute_and_register_element_idsave_for_app_testingto_key)StreamlitAPIExceptionStreamlitMissingPageLabelErrorStreamlitPageNotFoundError)get_main_script_directorynormalize_path_join) StreamlitPage)Button)DownloadButton) LinkButton)PageLink)gather_metrics)ScriptRunContextget_script_run_ctx) WidgetArgsWidgetCallback WidgetKwargsregister_widget)validate_icon_or_emoji)is_url)DeltaGeneratorz For more information, refer to the [documentation for forms](https://docs.streamlit.io/develop/api-reference/execution-flow/st.form). rFORM_DOCS_INFOr DownloadButtonDataTypec@s"eZdZdddZddd d Zd S) ButtonSerdevboolreturncCst|SN)r.)selfr-r2]/var/www/html/chatdoc2/venv/lib/python3.10/site-packages/streamlit/elements/widgets/button.py serializeOzButtonSerde.serializeui_value bool | None widget_idstrcCs|pdS)NFr2)r1r7r9r2r2r3 deserializeRr5zButtonSerde.deserializeN)r-r.r/r.)r6)r7r8r9r:r/r.)__name__ __module__ __qualname__r4r;r2r2r2r3r,Ms r,c@s(eZdZed     d=dddddd>ddZed       d?dddddd@d d!Zed"dddddd#dAd&d'Zed(dddddd)dBd-d.Z       d?dddddd/dCd2d3ZddddddAd4d5Z dddddd)dBd6d7Z   dDdddddd/dEd9d:Z e dFd;d<Z dS)G ButtonMixinbuttonN secondaryF)typeicondisableduse_container_widthlabelr:key Key | Nonehelp str | Noneon_clickWidgetCallback | NoneargsWidgetArgs | NonekwargsWidgetKwargs | NonerB+Literal['primary', 'secondary', 'tertiary']rCrDr.rEr/c CsJt|}t} |dvrtd|d|jj|||d|||| ||| | d S)uDisplay a button widget. Parameters ---------- label : str A short label explaining to the user what this button is for. The label can optionally contain GitHub-flavored Markdown of the following types: Bold, Italics, Strikethroughs, Inline Code, Links, 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. Display unsupported elements as literal characters by backslash-escaping them. E.g., ``"1\. Not an ordered list"``. 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 key : str or int An optional string or integer to use as the unique key for the widget. If this is omitted, a key will be generated for the widget based on its content. No two widgets may have the same key. help : str or None A tooltip that gets displayed when the button is hovered over. If this is ``None`` (default), no tooltip is displayed. The tooltip can optionally contain GitHub-flavored Markdown, including the Markdown directives described in the ``body`` parameter of ``st.markdown``. on_click : callable An optional callback invoked when this button is clicked. args : tuple An optional tuple of args to pass to the callback. kwargs : dict An optional dict of kwargs to pass to the callback. type : "primary", "secondary", or "tertiary" An optional string that specifies the button type. This can be one of the following: - ``"primary"``: The button's background is the app's primary color for additional emphasis. - ``"secondary"`` (default): The button's background coordinates with the app's background color for normal emphasis. - ``"tertiary"``: The button is plain text without a border or background for subtly. icon : str or None An optional emoji or icon to display next to the button label. If ``icon`` is ``None`` (default), no icon is displayed. 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. disabled : bool An optional boolean that disables the button if set to ``True``. The default is ``False``. use_container_width : bool Whether to expand the button's width to fill its parent container. If ``use_container_width`` is ``False`` (default), Streamlit sizes the button to fit its contents. If ``use_container_width`` is ``True``, the width of the button matches its parent container. In both cases, if the contents of the button are wider than the parent container, the contents will line wrap. Returns ------- bool True if the button was clicked on the last run of the app, False otherwise. Examples -------- **Example 1: Customize your button type** >>> import streamlit as st >>> >>> st.button("Reset", type="primary") >>> if st.button("Say hello"): ... st.write("Why hello there") ... else: ... st.write("Goodbye") >>> >>> if st.button("Aloha", type="tertiary"): ... st.write("Ciao") .. output:: https://doc-buton.streamlit.app/ height: 300px **Example 2: Add icons to your button** Although you can add icons to your buttons through Markdown, the ``icon`` parameter is a convenient and consistent alternative. >>> import streamlit as st >>> >>> left, middle, right = st.columns(3) >>> if left.button("Plain button", use_container_width=True): ... left.markdown("You clicked the plain button.") >>> if middle.button("Emoji button", icon="😃", use_container_width=True): ... middle.markdown("You clicked the emoji button.") >>> if right.button("Material button", icon=":material/mood:", use_container_width=True): ... right.markdown("You clicked the Material button.") .. output:: https://doc-button-icons.streamlit.app/ height: 220px primaryrAtertiaryzhThe type argument to st.button must be "primary", "secondary", or "tertiary". The argument passed was "".F) is_form_submitterrKrMrOrDrBrCrEctx)rr"rdg_button) r1rFrGrIrKrMrOrBrCrDrErWr2r2r3r@Ws.zButtonMixin.buttondownload_buttondatar+ file_namemimec CsDt}| dvrtd| d|j||||||||| | | | | |dS)uUDisplay a download button widget. This is useful when you would like to provide a way for your users to download a file directly from your app. Note that the data to be downloaded is stored in-memory while the user is connected, so it's a good idea to keep file sizes under a couple hundred megabytes to conserve memory. If you want to prevent your app from rerunning when a user clicks the download button, wrap the download button in a `fragment `_. Parameters ---------- label : str A short label explaining to the user what this button is for. The label can optionally contain GitHub-flavored Markdown of the following types: Bold, Italics, Strikethroughs, Inline Code, Links, 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. Display unsupported elements as literal characters by backslash-escaping them. E.g., ``"1\. Not an ordered list"``. 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 data : str or bytes or file The contents of the file to be downloaded. See example below for caching techniques to avoid recomputing this data unnecessarily. file_name: str An optional string to use as the name of the file to be downloaded, such as 'my_file.csv'. If not specified, the name will be automatically generated. mime : str or None The MIME type of the data. If None, defaults to "text/plain" (if data is of type *str* or is a textual *file*) or "application/octet-stream" (if data is of type *bytes* or is a binary *file*). key : str or int An optional string or integer to use as the unique key for the widget. If this is omitted, a key will be generated for the widget based on its content. No two widgets may have the same key. help : str or None A tooltip that gets displayed when the button is hovered over. If this is ``None`` (default), no tooltip is displayed. The tooltip can optionally contain GitHub-flavored Markdown, including the Markdown directives described in the ``body`` parameter of ``st.markdown``. on_click : callable An optional callback invoked when this button is clicked. args : tuple An optional tuple of args to pass to the callback. kwargs : dict An optional dict of kwargs to pass to the callback. type : "primary", "secondary", or "tertiary" An optional string that specifies the button type. This can be one of the following: - ``"primary"``: The button's background is the app's primary color for additional emphasis. - ``"secondary"`` (default): The button's background coordinates with the app's background color for normal emphasis. - ``"tertiary"``: The button is plain text without a border or background for subtly. icon : str or None An optional emoji or icon to display next to the button label. If ``icon`` is ``None`` (default), no icon is displayed. 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. disabled : bool An optional boolean that disables the download button if set to ``True``. The default is ``False``. use_container_width : bool Whether to expand the button's width to fill its parent container. If ``use_container_width`` is ``False`` (default), Streamlit sizes the button to fit its contents. If ``use_container_width`` is ``True``, the width of the button matches its parent container. In both cases, if the contents of the button are wider than the parent container, the contents will line wrap. Returns ------- bool True if the button was clicked on the last run of the app, False otherwise. Examples -------- Download a large DataFrame as a CSV: >>> import streamlit as st >>> >>> @st.cache_data ... def convert_df(df): ... # IMPORTANT: Cache the conversion to prevent computation on every rerun ... return df.to_csv().encode("utf-8") >>> >>> csv = convert_df(my_large_df) >>> >>> st.download_button( ... label="Download data as CSV", ... data=csv, ... file_name="large_df.csv", ... mime="text/csv", ... ) Download a string as a file: >>> import streamlit as st >>> >>> text_contents = '''This is some text''' >>> st.download_button("Download some text", text_contents) Download a binary file: >>> import streamlit as st >>> >>> binary_contents = b"example content" >>> # Defaults to "application/octet-stream" >>> st.download_button("Download binary file", binary_contents) Download an image: >>> import streamlit as st >>> >>> with open("flower.png", "rb") as file: ... btn = st.download_button( ... label="Download image", ... data=file, ... file_name="flower.png", ... mime="image/png", ... ) .. output:: https://doc-download-buton.streamlit.app/ height: 335px rRzqThe type argument to st.download_button must be "primary", "secondary", or "tertiary". The argument passed was "rU)rFr[r\r]rGrIrKrMrOrBrCrDrErW)r"r_download_button)r1rFr[r\r]rGrIrKrMrOrBrCrDrErWr2r2r3rZs0<zButtonMixin.download_button link_button)rIrBrCrDrEurlr)c Cs0|dvr td|d|j|||||||dS)uDisplay a link button element. When clicked, a new tab will be opened to the specified URL. This will create a new session for the user if directed within the app. Parameters ---------- label : str A short label explaining to the user what this button is for. The label can optionally contain GitHub-flavored Markdown of the following types: Bold, Italics, Strikethroughs, Inline Code, Links, 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. Display unsupported elements as literal characters by backslash-escaping them. E.g., ``"1\. Not an ordered list"``. 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 url : str The url to be opened on user click help : str or None A tooltip that gets displayed when the button is hovered over. If this is ``None`` (default), no tooltip is displayed. The tooltip can optionally contain GitHub-flavored Markdown, including the Markdown directives described in the ``body`` parameter of ``st.markdown``. type : "primary", "secondary", or "tertiary" An optional string that specifies the button type. This can be one of the following: - ``"primary"``: The button's background is the app's primary color for additional emphasis. - ``"secondary"`` (default): The button's background coordinates with the app's background color for normal emphasis. - ``"tertiary"``: The button is plain text without a border or background for subtly. icon : str or None An optional emoji or icon to display next to the button label. If ``icon`` is ``None`` (default), no icon is displayed. 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. disabled : bool An optional boolean that disables the link button if set to ``True``. The default is ``False``. use_container_width : bool Whether to expand the button's width to fill its parent container. If ``use_container_width`` is ``False`` (default), Streamlit sizes the button to fit its contents. If ``use_container_width`` is ``True``, the width of the button matches its parent container. In both cases, if the contents of the button are wider than the parent container, the contents will line wrap. Example ------- >>> import streamlit as st >>> >>> st.link_button("Go to gallery", "https://streamlit.io/gallery") .. output:: https://doc-link-button.streamlit.app/ height: 200px rRzmThe type argument to st.link_button must be "primary", "secondary", or "tertiary". The argument passed was "rU)rFr`rIrDrBrCrE)r _link_button)r1rFr`rIrBrCrDrEr2r2r3r_sezButtonMixin.link_button page_link)rFrCrIrDrEpagestr | Path | StreamlitPager8cCs|j||||||dS)uvDisplay a link to another page in a multipage app or to an external page. If another page in a multipage app is specified, clicking ``st.page_link`` stops the current page execution and runs the specified page as if the user clicked on it in the sidebar navigation. If an external page is specified, clicking ``st.page_link`` opens a new tab to the specified page. The current script run will continue if not complete. 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. Alternatively, this can be the URL to an external page (must start with "http://" or "https://"). label : str The label for the page link. Labels are required for external pages. The label can optionally contain GitHub-flavored Markdown of the following types: Bold, Italics, Strikethroughs, Inline Code, Links, 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. Display unsupported elements as literal characters by backslash-escaping them. E.g., ``"1\. Not an ordered list"``. 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 button label. If ``icon`` is ``None`` (default), no icon is displayed. 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. help : str or None A tooltip that gets displayed when the link is hovered over. If this is ``None`` (default), no tooltip is displayed. The tooltip can optionally contain GitHub-flavored Markdown, including the Markdown directives described in the ``body`` parameter of ``st.markdown``. disabled : bool An optional boolean that disables the page link if set to ``True``. The default is ``False``. use_container_width : bool Whether to expand the link's width to fill its parent container. The default is ``True`` for page links in the sidebar and ``False`` for those in the main app. Example ------- Consider the following example given this file structure: >>> your-repository/ >>> ├── pages/ >>> │ ├── page_1.py >>> │ └── page_2.py >>> └── your_app.py >>> import streamlit as st >>> >>> st.page_link("your_app.py", label="Home", icon="🏠") >>> st.page_link("pages/page_1.py", label="Page 1", icon="1️⃣") >>> st.page_link("pages/page_2.py", label="Page 2", icon="2️⃣", disabled=True) >>> st.page_link("http://www.google.com", label="Google", icon="🌎") The default navigation is shown here for comparison, but you can hide the default navigation using the |client.showSidebarNavigation|_ configuration option. This allows you to create custom, dynamic navigation menus for your apps! .. |client.showSidebarNavigation| replace:: ``client.showSidebarNavigation`` .. _client.showSidebarNavigation: https://docs.streamlit.io/develop/api-reference/configuration/config.toml#client .. output :: https://doc-page-link.streamlit.app/ height: 350px )rcrFrCrIrDrE) _page_link)r1rcrFrCrIrDrEr2r2r3rbKsozButtonMixin.page_link)rBrCrDrErWrWScriptRunContext | Nonec  Cst|}t|j||dddtd|d|| |||| | d }t|jr(tdtt}||_| |_ ||_ d|_ | |_ t |j||||| |_|durQt||_| durZt| |_t}t|j||| |j|j|dd}|jd||jS)NF) default_valuewrites_allowedrZ) user_keyform_idrFrCr\r]rIrBrEz7`st.download_button()` can't be used in an `st.form()`. trigger_valueon_change_handlerrMrO deserializer serializerrW value_type)rrrXrrrr*DownloadButtonProtoidrErFdefaultrB marshall_file_get_delta_path_strrDrrIr'rCr,r&r;r4_enqueuevalue)r1rFr[r\r]rGrIrKrMrOrBrCrDrErW element_iddownload_button_protoserde button_stater2r2r3r^sf    zButtonMixin._download_buttonc CsVt}||_||_||_||_||_|durt||_|dur$t||_ |j d|S)Nr_) LinkButtonProtorFr`rBrErDrrIr'rCrXrv) r1rFr`rIrBrCrDrElink_button_protor2r2r3ras   zButtonMixin._link_buttoncCst}t}|s|jd|S||_|dur||_|dur"t||_|dur+t||_ |dur2||_ t |t rH|j |_|j|_|durG|j|_n}t |trQt|}t|rm|dus]|dkr`t||_d|_|jd|Sd} i} |j} |j} t| } tjt| |} | D]#} | d}| d}| |kr|dur| dd|_| d|_||_nq|jdkr|jduo|jj!d k}t"||| d |jd|S) Nrbr6T script_path page_name_ page_script_hash) is_mpa_v2rcmain_script_directory)# PageLinkProtor"rXrvrDrFr'rCrrIrE isinstancer _script_hashrurl_pathrctitlerr:r(rexternalmain_script_path pages_manager get_pagesrospathrealpathrvaluesreplace mpa_versionr)r1rcrFrCrIrDrEpage_link_protorWctx_main_script all_app_pagesrrequested_page page_data full_pathrrr2r2r3re-sl         zButtonMixin._page_linkrVc Cs0t|}t|j||dd| d|rt|jnd} td|| || |||| d }trFt|jr8|s8tdt t|jsF|rFtdt t }||_ ||_ d|_ ||_| |_||_| |_| |_|durjt||_| durst| |_t}t|j ||||j|j| dd }| rt| ||j|jd||jS) NF)rgrhenable_check_callback_rulesr6r@)rirjrFrCrIrVrBrEz.`st.button()` can't be used in an `st.form()`.z=`st.form_submit_button()` must be used inside an `st.form()`.rkrl)rrrXrrrexistsrrr* ButtonProtorrrFrsrVrjrBrErDrrIr'rCr,r&r;r4rrwrv)r1rFrGrIrVrKrMrOrBrCrDrErWrjrx button_protorzr{r2r2r3rYst    zButtonMixin._buttoncCs td|S)zGet our DeltaGenerator.r))r )r1r2r2r3rXs zButtonMixin.dg)NNNNN)rFr:rGrHrIrJrKrLrMrNrOrPrBrQrCrJrDr.rEr.r/r.)NNNNNNN)rFr:r[r+r\rJr]rJrGrHrIrJrKrLrMrNrOrPrBrQrCrJrDr.rEr.r/r.)rFr:r`r:rIrJrBrQrCrJrDr.rEr.r/r))rcrdrFrJrCrJrIrJrDr.rEr8r/r))rFr:r[r+r\rJr]rJrGrHrIrJrKrLrMrNrOrPrBrQrCrJrDr.rEr.rWrfr/r.)NNN)rFr:rGrJrIrJrVr.rKrLrMrNrOrPrBrQrCrJrDr.rEr.rWrfr/r.)r/r))r<r=r>r r@rZr_rbr^rarerYpropertyrXr2r2r2r3r?Vs + Tt{ VY \r? coordinatesr:r[proto_download_buttonrqmimetyperJr\r/NonecCst|tr|}|p d}net|tjr!|}|}|pd}nRt|tr-|}|p+d}nFt|tjrA|d| }|p?d}n2t|tj rU|d|}|pSd}nt|tj rk|d|ped}|pid}nt dt |trtjj||||dd}nd}||_dS) Nz text/plainzapplication/octet-streamrzInvalid binary data format: %sT)r\is_for_static_downloadr6)rr:encodeio TextIOWrapperreadbytesBytesIOseekgetvalueBufferedReader RawIOBase RuntimeErrorrBrr get_instancemedia_file_mgraddr`)rr[rrr\ data_as_bytes string_datafile_urlr2r2r3rtsB                  rtr0) rr:r[r+rrqrrJr\rJr/r)N __future__rrr dataclassesrpathlibrtextwraprtypingrrrr r r r typing_extensionsr streamlitr!streamlit.elements.lib.form_utilsrrstreamlit.elements.lib.policiesrstreamlit.elements.lib.utilsrrrrstreamlit.errorsrrrstreamlit.file_utilrrstreamlit.navigation.pagerstreamlit.proto.Button_pb2rr"streamlit.proto.DownloadButton_pb2rrqstreamlit.proto.LinkButton_pb2rr|streamlit.proto.PageLink_pb2rrstreamlit.runtime.metrics_utilr streamlit.runtime.scriptrunnerr!r"streamlit.runtime.stater#r$r%r&streamlit.string_utilr'streamlit.url_utilr(streamlit.delta_generatorr)r*__annotations__r:rrr+r,r?rtr2r2r2r3sP   $