U ARdM'@sUddlZddlZddlZddlmZmZmZmZmZm Z ddl Z ddl m Z ddlmZddlmZddlmZddlmZddlmZdd lmZdd lmZerdd lmZejejej ej!ej"fZ#e eeed fe$d <ee%Z&GdddZ'dS)N) TYPE_CHECKINGAnyListTupleTypecast)Final) type_util)StreamlitAPIException) get_logger)gather_metrics)SessionStateProxy)is_mem_address_str) UserInfoProxy)DeltaGenerator. HELP_TYPESc@s>eZdZedddeeddddZedd d d ZdS) WriteMixinwriteFunsafe_allow_htmlN)argsrreturnc s|rtd|gjjs0t|dkr0tdfdd}|D]}t|tr`|qDt |r~|j |qDt |r|tt |dkrj|n j |qDt|tr|j|qDt|tr|j|qDt |r|j|qDt |dr<|j|qDt |r\|j|qDt |dr~|j|qDt |r|j|qDt |r|j|qDt |rd d l m!}||"|}j|#qDt|t$t%t&t'fr |j(|qDt )|rJ|j(t(*|+qDt ,|rj|j-|qDt./|r|jt0t1|qDt2|d rjj3|4d d qDt|}t5|r|j|qDd|6ddqD|dS)azWrite arguments to the app. This is the Swiss Army knife of Streamlit commands: it does different things depending on what you throw at it. Unlike other Streamlit commands, write() has some unique properties: 1. You can pass in multiple arguments, all of which will be written. 2. Its behavior depends on the input types as follows. 3. It returns None, so its "slot" in the App cannot be reused. Parameters ---------- *args : any One or many objects to print to the App. Arguments are handled as follows: - write(string) : Prints the formatted Markdown string, with support for LaTeX expression, emoji shortcodes, and colored text. See docs for st.markdown for more. - write(data_frame) : Displays the DataFrame as a table. - write(error) : Prints an exception specially. - write(func) : Displays information about a function. - write(module) : Displays information about the module. - write(class) : Displays information about a class. - write(dict) : Displays dict in an interactive widget. - write(mpl_fig) : Displays a Matplotlib figure. - write(altair) : Displays an Altair chart. - write(keras) : Displays a Keras model. - write(graphviz) : Displays a Graphviz graph. - write(plotly_fig) : Displays a Plotly figure. - write(bokeh_fig) : Displays a Bokeh figure. - write(sympy_expr) : Prints SymPy expression using LaTeX. - write(htmlable) : Prints _repr_html_() for the object if available. - write(obj) : Prints str(obj) if otherwise unknown. unsafe_allow_html : bool This is a keyword-only argument that defaults to False. By default, any HTML tags found in strings will be escaped and therefore treated as pure text. This behavior may be turned off by setting this argument to True. That said, *we strongly advise against it*. It is hard to write secure HTML, so by using this argument you may be compromising your users' security. For more information, see: https://github.com/streamlit/streamlit/issues/152 Example ------- Its basic use case is to draw Markdown-formatted text, whenever the input is a string: >>> import streamlit as st >>> >>> st.write('Hello, *World!* :sunglasses:') .. output:: https://doc-write1.streamlitapp.com/ height: 150px As mentioned earlier, ``st.write()`` also accepts other data formats, such as numbers, data frames, styled data frames, and assorted objects: >>> import streamlit as st >>> import pandas as pd >>> >>> st.write(1234) >>> st.write(pd.DataFrame({ ... 'first column': [1, 2, 3, 4], ... 'second column': [10, 20, 30, 40], ... })) .. output:: https://doc-write2.streamlitapp.com/ height: 350px Finally, you can pass in multiple arguments to do things like: >>> import streamlit as st >>> >>> st.write('1 + 1 = ', 2) >>> st.write('Below is a DataFrame:', data_frame, 'Above is a dataframe.') .. output:: https://doc-write3.streamlitapp.com/ height: 410px Oh, one more thing: ``st.write`` accepts chart objects too! For example: >>> import streamlit as st >>> import pandas as pd >>> import numpy as np >>> import altair as alt >>> >>> df = pd.DataFrame( ... np.random.randn(200, 3), ... columns=['a', 'b', 'c']) ... >>> c = alt.Chart(df).mark_circle().encode( ... x='a', y='b', size='c', color='c', tooltip=['a', 'b', 'c']) >>> >>> st.write(c) .. output:: https://doc-vega-lite-chart.streamlitapp.com/ height: 300px zInvalid arguments were passed to "st.write" function. Support for passing such unknown keywords arguments will be dropped in future. Invalid arguments were: %szCannot replace a single element with multiple elements. The `write()` method only supports multiple elements when inserting elements rather than replacing. That is, only when called as `st.write()` or `st.sidebar.write()`.cs*r&jjddgdd<dS)N r)dgmarkdownjoinselfZ string_bufferrr.flush_bufferzmatplotlib.figure.Figurezbokeh.plotting.figure.Figurer) vis_utils _repr_html_Trz`%s``z\`N)7_LOGGERwarningrZ _is_top_levellenr isinstancestrappendr Z"is_snowpark_or_pyspark_data_objectZ dataframeZis_dataframe_likenpshapetext Exception exceptionrhelpZis_altair_chartZ altair_chartZis_typeZpyplotZis_plotly_chartZ plotly_chartZ bokeh_chartZis_graphviz_chartZgraphviz_chartZis_sympy_expessionZlatexZis_keras_modelZtensorflow.python.keras.utilsr#Z model_to_dotZ to_stringdictlistr rjsonZ is_namedtupledumps_asdictZ is_pydeckZ pydeck_chartinspectisclassrtypehasattrrr$rreplace) rrrkwargsr!argr#dotZstringified_argrrr r0sq                   zWriteMixin.writer)rcCs td|S)zGet our DeltaGenerator.r)r)rrrr rsz WriteMixin.dg) __name__ __module__ __qualname__r rboolrpropertyrrrrr r/s Xr)(r7r4typestypingrrrrrrZnumpyr,Ztyping_extensionsrZ streamlitr Zstreamlit.errorsr Zstreamlit.loggerr Zstreamlit.runtime.metrics_utilr Zstreamlit.runtime.stater Zstreamlit.string_utilrZstreamlit.user_inforZstreamlit.delta_generatorrBuiltinFunctionTypeBuiltinMethodType FunctionType MethodType ModuleTyper__annotations__r?r&rrrrr s.