&e!\ UddlZddlmZddlmZddlmZmZmZm Z m Z m Z ddl m Z mZddlmZddlmZmZddlmZmZdd lmZdd lmZdd lmZdd lm Z!dd l"m#Z#ddl$m%Z%m&Z&ddl'm(Z(m)Z)m*Z*m+Z+ddl,m-Z-ddl.m/Z/m0Z0erddl1m2Z2dZ3e e4d<e e5e6e eej7fZ8eGddZ9GddZ: d de5de8dedee5dee5ddf dZ;dS)!N) dataclass)dedent) TYPE_CHECKINGBinaryIOOptionalTextIOUnioncast)FinalLiteral)runtime)current_form_id is_in_form)check_callback_rulescheck_session_state_rules)StreamlitAPIException)Button)DownloadButton) LinkButton)gather_metrics)ScriptRunContextget_script_run_ctx) WidgetArgsWidgetCallback WidgetKwargsregister_widget)compute_widget_id)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@eZdZdedefdZd deededefdZdS) ButtonSerdevreturnc t|SN)bool)selfr$s Alib/python3.11/site-packages/streamlit/elements/widgets/button.py serializezButtonSerde.serialize6s Awwui_value widget_idc |pdS)NF)r)r.r/s r* deserializezButtonSerde.deserialize9s  5 r,N)r-)__name__ __module__ __qualname__r(r+rstrr2r1r,r*r#r#4sh4D!!HTN!s!D!!!!!!r,r#ceZdZed d#dddddedeedeed eed eed ee d e d de de de fdZ ed d$dddddede deedeedeedeed eed eed ee d e d de de de fdZedddddddededeed e d de de ddfdZ d$ddddddede deedeedeedeed eed eed ee d e d de de deede fdZdddddededeed e d de de ddfdZ d%ddddddedeedeed e d eed eed ee d e d de de deede fd!Zed&d"ZdS)' ButtonMixinbuttonN secondaryF)typedisableduse_container_widthlabelkeyhelpon_clickargskwargsr;primaryr:r<r=r%c t|}t} |dvrtd|d|j|||d|||||| |  S)am 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, gray/grey, rainbow. 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. Defaults to "secondary". disabled : bool An optional boolean, which disables the button if set to True. The default is False. 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 >>> >>> st.button("Reset", type="primary") >>> if st.button('Say hello'): ... st.write('Why hello there') ... else: ... st.write('Goodbye') .. output:: https://doc-buton.streamlit.app/ height: 220px rD[The type argument to st.button must be "primary" or "secondary". The argument passed was "".F)is_form_submitterrArBrCr<r;r=ctx)rrrdg_button) r)r>r?r@rArBrCr;r<r=rJs r*r9zButtonMixin.button>sjSkk "" / / /'5,0555  w   # 3   r,download_buttondata file_namemimec t} | dvrtd| 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, gray/grey, rainbow. 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. 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. Defaults to "secondary". disabled : bool An optional boolean, which disables the download button if set to True. The default is False. 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.streamlit.app/ height: 335px rDrGrH) r>rNrOrPr?r@rArBrCr<r;r=rJ)rr_download_button)r)r>rNrOrPr?r@rArBrCr;r<r=rJs r*rMzButtonMixin.download_buttonsd!"" / / /'5,0555  $$ 3%   r, link_button)r@r;r<r=urlr cf|dvrtd|d|||||||S)a8 Display 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 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, gray/grey, rainbow. 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``. url : str The url to be opened on user click help : str An optional tooltip that gets displayed when the button is hovered over. 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. Defaults to "secondary". disabled : bool An optional boolean, which disables the link button if set to True. The default is False. use_container_width: bool An optional boolean, which makes the button stretch its width to match the parent container. Example ------- >>> import streamlit as st >>> >>> st.link_button("Go to gallery", "https://streamlit.io/gallery") .. output:: https://doc-link-button.streamlit.app/ height: 200px rDz`The type argument to st.link_button must be "primary" or "secondary". The argument passed was "rH)r>rTr@r<r;r=)r _link_button)r)r>rTr@r;r<r=s r*rSzButtonMixin.link_buttonUskH / / /'7.2777     3 !   r,)r;r<r=rJrJc  rt|}td|dtd||||||| | | r| jnd }t |jrt dtt}||_ | |_ ||_ d|_ | |_ t|j||||| |_|t#||_t'}t)d||||| |j|j|  }|jd||jS)NF default_valuer?writes_allowedrM) user_keyr>rOrPr?r@r;r=pagez7`st.download_button()` can't be used in an `st.form()`.r[on_change_handlerrBrC deserializer serializerrJ)rrrpage_script_hashrrKrr!DownloadButtonProtoidr=r>defaultr; marshall_file_get_delta_path_strr<rr@r#rr2r+_enqueuevalue)r)r>rNrOrPr?r@rArBrCr;r<r=rJrcdownload_button_protoserde button_states r*rRzButtonMixin._download_buttons}"Skk!#eTTTT   3),6%%$     dg   'Z.ZZ !4 5 5#% 4G1&+#(-%%)" G ' ' ) )41Fi   *2&  )/ ! & &  !&*     *,ABBB!!r,ct}||_||_||_||_||_|t ||_|j d|S)NrS) LinkButtonProtor>rTr;r=r<rr@rKrg)r)r>rTr@r;r<r=link_button_protos r*rVzButtonMixin._link_buttonsk,--"' #!%0C-%-"  %+D\\  "w /@AAAr,rIc |st|j|td|dtd||||||| | r| jnd } t jrZt|jr|stdtt|js|rtdtt} | | _ || _ d| _ || _t|j| _|| _| | _| | _|t)|| _t-}t/d| |||||j|j|  }|jd| |jS)NFrXr9)r[r>r?r@rIr;r=r\z.`st.button()` can't be used in an `st.form()`.z=`st.form_submit_button()` must be used inside an `st.form()`.r])rrKrrrar existsrrr! ButtonProtorcr>rdrIrform_idr;r=r<rr@r#rr2r+rgrh)r)r>r?r@rIrArBrCr;r<r=rJrc button_protorjrks r*rLzButtonMixin._buttons! 4 ( 3 3 3!#eTTTT  / 3),6%%$    " >   $'"" +< +U^UU (( -> +dTbdd#}}  " $ ): &.tw77  +> ( (    &t L  &  &*     <000!!r,c"td|S)zGet our DeltaGenerator.r )r )r)s r*rKzButtonMixin.dgPs$d+++r,)NNNNN)NNNNNNN)NNN)r%r )r3r4r5rr6rrrrrr r(r9DownloadButtonDataTyperMrSrrRrVrLpropertyrKr1r,r*r8r8=sO^H""-1%))-j 1<$)j j j j c]j sm j >* j z" j &j ,-j j "j  j j j j X^%&& $("!"-1%))-g 1<$)g g g g %g C= g sm g c] g smg >*g z"g &g ,-g g "g  g g g '&g R^M"" #0;$)P P P P P sm P ,- P P "P  P P P #"P l$("!"-1%))-C"1<$)*.C"C"C"C"%C"C= C" sm C" c] C"smC">*C"z"C"&C",-C"C""C"& 'C" !C"C"C"C"V1<$)BBBBBsm B ,- BB"B BBBB8.2%))-K"1<$)*.K"K"K"K"c]K"sm K"  K" >* K"z"K"&K",-K"K""K"& 'K" K"K"K"K"Z,,,X,,,r,r8 coordinatesrNproto_download_buttonmimetyperOr%ct|tr|}|pd}n]t|tjr.|}|}|pd}nt|t r|}|pd}nt|tjr.|d| }|pd}nt|tj r.|d|}|pd}nit|tj r0|d|pd}|pd}ntdt|ztjr1tjj||||d}nd}||_dS) Nz text/plainzapplication/octet-streamrr,zInvalid binary data format: %sT)rOis_for_static_downloadr-) isinstancer6encodeio TextIOWrapperreadbytesBytesIOseekgetvalueBufferedReader RawIOBase RuntimeErrorr;r rp get_instancemedia_file_mgraddrT)rwrNrxryrO data_as_bytes string_datafile_urls r*rereVs$J +| D"* + +Jiikk #**,, +| D% J 99 D"* % % J !   99 D"+ , , J !  99 D", ' 'J !  *s 99;d4jjHIII~ '))8<<   #' =   (r,r')rs !!!!!!IIIIIIIIIIIIIIII,,,,,,,,????????TTTTTTTT222222<<<<<<TTTTTTHHHHHH999999OOOOOOOO =<<<<<++++++++9888888 sE68R\IJ !!!!!!! !V,V,V,V,V,V,V,V,| $ .).).) .)/.)sm .) } .)  .).).).).).)r,