U ARdG@s\UddlZddlmZddlmZddlmZmZmZm Z m Z m Z ddl m Z mZddlmZddlmZmZddlmZmZdd lmZdd lmZdd lmZdd lm Z dd l!m"Z"m#Z#ddl$m%Z%m&Z&m'Z'm(Z(ddl)m*Z*m+Z+erddl,m-Z-dZ.e e/d<e e0e1e eej2fZ3eGdddZ4GdddZ5de0e3eee0ee0ddddZ6dS)N) dataclass)dedent) TYPE_CHECKINGBinaryIOOptionalTextIOUnioncast)FinalLiteral)runtime)current_form_id is_in_form)check_callback_rulescheck_session_state_rules)StreamlitAPIException)Button)DownloadButton)gather_metrics)ScriptRunContextget_script_run_ctx) WidgetArgsWidgetCallback WidgetKwargsregister_widget)Keyto_key)DeltaGeneratorz For more information, refer to the [documentation for forms](https://docs.streamlit.io/library/api-reference/control-flow/st.form). FORM_DOCS_INFOc@s4eZdZeedddZd eeeedddZdS) ButtonSerde)vreturncCst|S)N)bool)selfr r$=/tmp/pip-unpacked-wheel-b9et7o5g/streamlit/elements/button.py serialize5szButtonSerde.serialize)ui_value widget_idr!cCs|pdS)NFr$)r#r(r)r$r$r% deserialize8szButtonSerde.deserializeN)r')__name__ __module__ __qualname__r"r&rstrr*r$r$r$r%r3src@s\eZdZeddddddeeeeeeeeeee e de e e d dd Z ed dddd ee eeeeeeeeeeeeee e e e d d dZdddddee eeeeeeeeeeeeee e e eee d ddZddddddeeeeee eeeeee e de e eee d ddZeddddZdS) ButtonMixinbuttonN secondaryF)typedisableduse_container_widthZprimaryr1) labelkeyhelpon_clickargskwargsr2r3r4r!c CsHt|}t} |dkr&td|d|jj|||d|||||| | d S)a Display a button widget. Parameters ---------- label : str A short label explaining to the user what this button is for. The label can optionally contain Markdown and supports the following elements: Bold, Italics, Strikethroughs, Inline Code, and Emojis. This also supports: * Emoji shortcodes, such as ``:+1:`` and ``:sunglasses:``. For a list of all supported codes, see https://share.streamlit.io/streamlit/emoji-shortcodes. * LaTeX expressions, by wrapping them in "$" or "$$" (the "$$" must be on their own lines). Supported LaTeX functions are listed at https://katex.org/docs/supported.html. * Colored text, using the syntax ``:color[text to be colored]``, where ``color`` needs to be replaced with any of the following supported colors: blue, green, orange, red, violet. Unsupported 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``. 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. Multiple widgets of the same type may not share the same key. help : str An optional tooltip that gets displayed when the button is hovered over. 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 : "secondary" or "primary" An optional string that specifies the button type. Can be "primary" for a button with additional emphasis or "secondary" for a normal button. This argument can only be supplied by keyword. Defaults to "secondary". disabled : bool An optional boolean, which disables the button if set to True. The default is False. This argument can only be supplied by keyword. use_container_width: bool An optional boolean, which makes the button stretch its width to match the parent container. Returns ------- bool True if the button was clicked on the last run of the app, False otherwise. Example ------- >>> import streamlit as st >>> >>> if st.button('Say hello'): ... st.write('Why hello there') ... else: ... st.write('Goodbye') .. output:: https://doc-buton.streamlitapp.com/ height: 220px r5z[The type argument to st.button must be "primary" or "secondary". The argument passed was "z".F)is_form_submitterr9r:r;r3r2r4ctx)rrrdg_button) r#r6r7r8r9r:r;r2r3r4r=r$r$r%r0=s&T zButtonMixin.buttondownload_button)r3r4) r6data file_namemimer7r8r9r:r;r3r4r!c  Cs(t} |j||||||||| | | | d S)aDisplay 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. Parameters ---------- label : str A short label explaining to the user what this button is for. The label can optionally contain Markdown and supports the following elements: Bold, Italics, Strikethroughs, Inline Code, and Emojis. This also supports: * Emoji shortcodes, such as ``:+1:`` and ``:sunglasses:``. For a list of all supported codes, see https://share.streamlit.io/streamlit/emoji-shortcodes. * LaTeX expressions, by wrapping them in "$" or "$$" (the "$$" must be on their own lines). Supported LaTeX functions are listed at https://katex.org/docs/supported.html. * Colored text, using the syntax ``:color[text to be colored]``, where ``color`` needs to be replaced with any of the following supported colors: blue, green, orange, red, violet. Unsupported 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``. 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. Multiple widgets of the same type may not share the same key. help : str An optional tooltip that gets displayed when the button is hovered over. 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. disabled : bool An optional boolean, which disables the download button if set to True. The default is False. This argument can only be supplied by keyword. use_container_width: bool An optional boolean, which makes the button stretch its width to match the parent container. 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 ... 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.streamlitapp.com/ height: 335px ) r6rArBrCr7r8r9r:r;r3r4r=)r_download_button) r#r6rArBrCr7r8r9r:r;r3r4r=r$r$r%r@s zButtonMixin.download_button)r3r4r=) r6rArBrCr7r8r9r:r;r3r4r=r!c  Cst|}td|ddt|jr.tdtt} | | _|| _d| _ t |j || |||dk rnt || _ t}td| |||| |j|j| d }| | _|jd| |jS)NF default_valuer7Zwrites_allowedz7`st.download_button()` can't be used in an `st.form()`.r@Zuser_keyZon_change_handlerr:r;Z deserializer serializerr=)rrrr>rrDownloadButtonProtor4r6default marshall_fileZ_get_delta_path_strrr8rrr*r&r3_enqueuevalue)r#r6rArBrCr7r8r9r:r;r3r4r=Zdownload_button_protoserde button_stater$r$r%rDFsD  zButtonMixin._download_button)r2r3r4r=) r6r7r8r<r9r:r;r2r3r4r=r!c Cs|st|j|td|ddtr`t|jrD|sDtdtnt|js`|r`tdtt} || _ d| _ || _ t |j| _ || _| | _|dk rt|| _t} td| ||||| j| j| d }| | _|jd| |jS)NFrEz.`st.button()` can't be used in an `st.form()`.z=`st.form_submit_button()` must be used inside an `st.form()`.r0rG)rr>rr existsrrr ButtonProtor6rJr<r Zform_idr2r4rr8rrr*r&r3rLrM)r#r6r7r8r<r9r:r;r2r3r4r=Z button_protorNrOr$r$r%r?sH   zButtonMixin._buttonr)r!cCs td|S)zGet our DeltaGenerator.r)r )r#r$r$r%r>szButtonMixin.dg)NNNNN)NNNNNNN)NNNNNNN)NNN)r+r,r-rr.rrrrrr r"r0DownloadButtonDataTyper@rrDr?propertyr>r$r$r$r%r/<s k !  ?  Br/) coordinatesrAproto_download_buttonmimetyperBr!cCst|tr|}|pd}nt|tjrB|}|}|p>d}nt|trZ|}|pVd}nt|tjr|d| }|p~d}ndt|tj r|d|}|pd}nsD