U ARd$@szddlmZmZmZmZddlmZddlm Z ddl m Z ddl m Z mZdZerhddlZddlmZGd d d ZdS) ) TYPE_CHECKINGOptionalUnioncast)Markdown)gather_metrics) clean_text) SupportsStris_sympy_expessionz---N)DeltaGeneratorc@seZdZeddddeeeeddddZed deeedd d d Z eddddeeeeddddZ eddde edfeeddddZ edddddZ eddddZdS) MarkdownMixinmarkdownFN)helpr )bodyunsafe_allow_htmlrreturncCs8t}t||_||_tjj|_|r*||_|j d|S)u5Display string formatted as Markdown. Parameters ---------- body : str The string to display as Github-flavored Markdown. Syntax information can be found at: https://github.github.com/gfm. 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. unsafe_allow_html : bool By default, any HTML tags found in the body 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 help : str An optional tooltip that gets displayed next to the Markdown. Examples -------- >>> import streamlit as st >>> >>> st.markdown('Streamlit is **_really_ cool**.') >>> st.markdown(”This text is :red[colored red], and this is **:blue[colored]** and bold.”) >>> st.markdown(":green[$\sqrt{x^2+y^2}=1$] is a Pythagorean identity. :pencil:") r ) MarkdownProtorr allow_htmlTypeZNATIVE element_typerdg_enqueue)selfrrrZmarkdown_protor?/tmp/pip-unpacked-wheel-b9et7o5g/streamlit/elements/markdown.pyr s5  zMarkdownMixin.markdowncodepython)rlanguagercCs>t}d|pdd|d}t||_tjj|_|jd|S)a+Display a code block with optional syntax highlighting. (This is a convenience wrapper around `st.markdown()`) Parameters ---------- body : str The string to display as code. language : str or None The language that the code is written in, for syntax highlighting. If ``None``, the code will be unstyled. Defaults to ``"python"``. For a list of available ``language`` values, see: https://github.com/react-syntax-highlighter/react-syntax-highlighter/blob/master/AVAILABLE_LANGUAGES_PRISM.MD Example ------- >>> import streamlit as st >>> >>> code = '''def hello(): ... print("Hello, Streamlit!")''' >>> st.code(code, language='python') z``` z ```r )rrrrZCODErrr)rrrZ code_protor rrrr^s   zMarkdownMixin.codecaptioncCs>t}t||_||_d|_tjj|_|r0||_|j d|S)a:Display text in small font. This should be used for captions, asides, footnotes, sidenotes, and other explanatory text. Parameters ---------- body : str The text to display as Github-flavored Markdown. Syntax information can be found at: https://github.github.com/gfm. 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. unsafe_allow_html : bool 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 help : str An optional tooltip that gets displayed next to the caption. Examples -------- >>> import streamlit as st >>> >>> st.caption('This is a string that explains something above.') >>> st.caption('A caption with _italics_ :blue[colors] and emojis :sunglasses:') Tr ) rrrrZ is_captionrZCAPTIONrrrr)rrrrZ caption_protorrrr s7  zMarkdownMixin.captionlatexz sympy.Expr)rrrcCsPt|rddl}||}t}dt||_tjj|_|rB||_ |j d|S)aDisplay mathematical expressions formatted as LaTeX. Supported LaTeX functions are listed at https://katex.org/docs/supported.html. Parameters ---------- body : str or SymPy expression The string or SymPy expression to display as LaTeX. If str, it's a good idea to use raw Python strings since LaTeX uses backslashes a lot. help : str An optional tooltip that gets displayed next to the LaTeX expression. Example ------- >>> import streamlit as st >>> >>> st.latex(r''' ... a + ar + a r^2 + a r^3 + \cdots + a r^{n-1} = ... \sum_{k=0}^{n-1} ar^k = ... a \left(\frac{1-r^{n}}{1-r}\right) ... ''') rNz$$ %s $$r ) r sympyr!rrrrZLATEXrrrr)rrrr"Z latex_protorrrr!s$  zMarkdownMixin.latexdivider)rcCs$t}t|_tjj|_|jd|S)aDisplay a horizontal rule. .. note:: You can achieve the same effect with st.write("---") or even just "---" in your script (via magic). Example ------- >>> import streamlit as st >>> >>> st.divider() r )r#MARKDOWN_HORIZONTAL_RULE_EXPRESSIONrrZDIVIDERrrr)rZ divider_protorrrr#s zMarkdownMixin.dividercCs td|S)zGet our DeltaGenerator.r )r)rrrrrszMarkdownMixin.dg)F)r)F)__name__ __module__ __qualname__rr boolrstrr rr rr!r#propertyrrrrrr sL>%? /r )typingrrrrZstreamlit.proto.Markdown_pb2rrZstreamlit.runtime.metrics_utilrZstreamlit.string_utilrZstreamlit.type_utilr r r$r"Zstreamlit.delta_generatorr r rrrrs