L i|JUddlmZddlmZmZmZmZddlmZm Z m Z m Z ddl m ZddlmZddlmZmZddlmZmZer ddlZdd lmZd Zd ed <Gd dZy)) annotations) TYPE_CHECKINGFinalLiteralcast) LayoutConfigWidthWidthWithoutContentvalidate_width)Markdown)gather_metrics) clean_textvalidate_icon_or_emoji) SupportsStris_sympy_expressionN)DeltaGeneratorz---r#MARKDOWN_HORIZONTAL_RULE_EXPRESSIONc(eZdZed dddd ddZed dddd ddZedddd dd Zed dd dd Zed dddd ddZe ddZ y) MarkdownMixinmarkdownNstretch)helpwidthct}t||_||_tjj |_|r||_t|dt|}|jjd||S)uDisplay string formatted as Markdown. Parameters ---------- body : any The text to display as GitHub-flavored Markdown. Syntax information can be found at: https://github.github.com/gfm. If anything other than a string is passed, it will be converted into a string behind the scenes using ``str(body)``. 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. - Streamlit logo shortcode. Use ``:streamlit:`` to add a little Streamlit flair to your text. - A limited set of typographical symbols. ``"<- -> <-> -- >= <= ~="`` becomes "← → ↔ — ≥ ≤ ≈" when parsed as Markdown. - Google Material Symbols (rounded style), using the syntax ``:material/icon_name:``, where "icon_name" is the name of the icon in snake case. For a complete list of icons, see Google's `Material Symbols `_ font library. - 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 and background colors for text, using the syntax ``:color[text to be colored]`` and ``:color-background[text to be colored]``, respectively. ``color`` must be replaced with any of the following supported colors: red, orange, yellow, green, blue, violet, gray/grey, rainbow, or primary. For example, you can use ``:orange[your text here]`` or ``:blue-background[your text here]``. If you use "primary" for color, Streamlit will use the default primary accent color unless you set the ``theme.primaryColor`` configuration option. - Colored badges, using the syntax ``:color-badge[text in the badge]``. ``color`` must be replaced with any of the following supported colors: red, orange, yellow, green, blue, violet, gray/grey, or primary. For example, you can use ``:orange-badge[your text here]`` or ``:blue-badge[your text here]``. - Small text, using the syntax ``:small[text to show small]``. unsafe_allow_html : bool Whether to render HTML within ``body``. If this is ``False`` (default), any HTML tags found in ``body`` will be escaped and therefore treated as raw text. If this is ``True``, any HTML expressions within ``body`` will be rendered. Adding custom HTML to your app impacts safety, styling, and maintainability. .. note:: If you only want to insert HTML or CSS without Markdown text, we recommend using ``st.html`` instead. help : str or None A tooltip that gets displayed next to the Markdown. 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``. width : "stretch", "content", or int The width of the Markdown element. This can be one of the following: - ``"stretch"`` (default): The width of the element matches the width of the parent container. - ``"content"``: The width of the element matches the width of its content, but doesn't exceed the width of the parent container. - An integer specifying the width in pixels: The element has a fixed width. If the specified width is greater than the width of the parent container, the width of the element matches the width of the parent container. Examples -------- >>> import streamlit as st >>> >>> st.markdown("*Streamlit* is **really** ***cool***.") >>> st.markdown(''' ... :red[Streamlit] :orange[can] :green[write] :blue[text] :violet[in] ... :gray[pretty] :rainbow[colors] and :blue-background[highlight] text.''') >>> st.markdown("Here's a bouquet —\ ... :tulip::cherry_blossom::rose::hibiscus::sunflower::blossom:") >>> >>> multi = '''If you end a line with two spaces, ... a soft return is used for the next line. ... ... Two (or more) newline characters in a row will result in a hard return. ... ''' >>> st.markdown(multi) .. output:: https://doc-markdown.streamlit.app/ height: 350px T allow_contentrr layout_config) MarkdownProtorbody allow_htmlTypeNATIVE element_typerr rdg_enqueue)selfr!unsafe_allow_htmlrrmarkdown_protors a/mnt/ssd/data/python-lab/Trading/venv/lib/python3.12/site-packages/streamlit/elements/markdown.pyrzMarkdownMixin.markdown'sph'(.$5!&3&8&8&?&?# "&N uD1$51 ww N-XXcaptionct}t||_||_d|_tj j |_|r||_t|dt|}|jjd||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. 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 unsafe_allow_html : bool Whether to render HTML within ``body``. If this is ``False`` (default), any HTML tags found in ``body`` will be escaped and therefore treated as raw text. If this is ``True``, any HTML expressions within ``body`` will be rendered. Adding custom HTML to your app impacts safety, styling, and maintainability. .. note:: If you only want to insert HTML or CSS without Markdown text, we recommend using ``st.html`` instead. help : str or None A tooltip that gets displayed next to the caption. 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``. width : "stretch", "content", or int The width of the caption element. This can be one of the following: - ``"stretch"`` (default): The width of the element matches the width of the parent container. - ``"content"``: The width of the element matches the width of its content, but doesn't exceed the width of the parent container. - An integer specifying the width in pixels: The element has a fixed width. If the specified width is greater than the width of the parent container, the width of the element matches the width of the parent container. 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:") Trrrr) r rr!r" is_captionr#CAPTIONr%rr rr&r')r(r!r)rr caption_protors r+r-zMarkdownMixin.captionsxF& '- #4  #'  %2%7%7%?%? " !%M uD1$51 ww MWWr,latexc>t|rddl}|j|}t}dt |d|_tj j|_|r||_ t|dt|}|jjd|| 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 or None A tooltip that gets displayed next to the LaTeX expression. 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``. width : "stretch", "content", or int The width of the LaTeX element. This can be one of the following: - ``"stretch"`` (default): The width of the element matches the width of the parent container. - ``"content"``: The width of the element matches the width of its content, but doesn't exceed the width of the parent container. - An integer specifying the width in pixels: The element has a fixed width. If the specified width is greater than the width of the parent container, the width of the element matches the width of the parent container. 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$$ z $$Trrrr)rsympyr2r rr!r#LATEXr%rr rr&r')r(r!rrr4 latex_protors r+r2zMarkdownMixin.latexsl t $ 5;;t$D#o !*T"2!348 #0#5#5#;#;  #K uD1$51 ww K}UUr,dividerrct}t|_tjj|_t |dt|}|jjd||S)a>Display a horizontal rule. .. note:: You can achieve the same effect with st.write("---") or even just "---" in your script (via magic). Parameters ---------- width : "stretch" or int The width of the divider element. This can be one of the following: - ``"stretch"`` (default): The width of the element matches the width of the parent container. - An integer specifying the width in pixels: The element has a fixed width. If the specified width is greater than the width of the parent container, the width of the element matches the width of the parent container. Example ------- >>> import streamlit as st >>> >>> st.divider() Frrrr) r rr!r#DIVIDERr%r rr&r')r(r divider_protors r+r7zMarkdownMixin.divider>sW8& @ %2%7%7%?%? "uE2$51 ww MWWr,badgebluecontent)iconcolorrcJ|t|dznd}|jddjdd}t}d|d||d|_tjj |_t|d t| }|jjd || S)uDisplay a colored badge with an icon and label. This is a thin wrapper around the color-badge Markdown directive. The following are equivalent: - ``st.markdown(":blue-badge[Home]")`` - ``st.badge("Home", color="blue")`` .. note:: You can insert badges everywhere Streamlit supports Markdown by using the color-badge Markdown directive. See ``st.markdown`` for more information. Parameters ---------- label : str The label to display in the badge. The label can optionally contain GitHub-flavored Markdown of the following types: Bold, Italics, Strikethroughs, Inline Code. See the ``body`` parameter of |st.markdown|_ for additional, supported Markdown directives. Because this command escapes square brackets (``[ ]``) in this parameter, any directive requiring square brackets is not supported. .. |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 badge 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. color : str The color to use for the badge. This defaults to ``"blue"``. This can be one of the following supported colors: red, orange, yellow, blue, green, violet, gray/grey, or primary. If you use ``"primary"``, Streamlit will use the default primary accent color unless you set the ``theme.primaryColor`` configuration option. width : "content", "stretch", or int The width of the badge element. This can be one of the following: - ``"content"`` (default): The width of the element matches the width of its content, but doesn't exceed the width of the parent container. - ``"stretch"``: The width of the element matches the width of the parent container. - An integer specifying the width in pixels: The element has a fixed width. If the specified width is greater than the width of the parent container, the width of the element matches the width of the parent container. Examples -------- Create standalone badges with ``st.badge`` (with or without icons). If you want to have multiple, side-by-side badges, you can use the Markdown directive in ``st.markdown``. >>> import streamlit as st >>> >>> st.badge("New") >>> st.badge("Success", icon=":material/check:", color="green") >>> >>> st.markdown( >>> ":violet-badge[:material/star: Favorite] :orange-badge[⚠️ Needs review] :gray-badge[Deprecated]" >>> ) .. output :: https://doc-badge.streamlit.app/ height: 220px  [z\[]z\]:z-badge[Trrrr) rreplacer r!r#r$r%r rr&r') r(labelr>r?ricon_str escaped_label badge_protors r+r;zMarkdownMixin.badgecsR:>9I)$/#5r c5199#uE #o ugWXJ}oQG #0#5#5#<#<  uD1$51 ww K}UUr,ctd|S)zGet our DeltaGenerator.r)r)r(s r+r&zMarkdownMixin.dgs$d++r,)F) r!rr)boolr str | Nonerr returnr)r!zSupportsStr | sympy.ExprrrMrr rNr)rr rNr) rGstrr>rMr?zXLiteral['red', 'orange', 'yellow', 'blue', 'green', 'violet', 'gray', 'grey', 'primary']rr rNr)rNr) __name__ __module__ __qualname__r rr-r2r7r;propertyr&r,r+rr&sJ#(~Y   ~Y~Y ~Y  ~Y  ~Y ~Y ~Y@I#(MX   MXMX MX  MX  MX MXMX^G   CV&CV CV  CV  CVCVJI6?"X"XHG    !tVtV tV  tV !tV" #tVtVl,,r,r) __future__rtypingrrrr#streamlit.elements.lib.layout_utilsrr r r streamlit.proto.Markdown_pb2r r streamlit.runtime.metrics_utilr streamlit.string_utilrrstreamlit.type_utilrrr4streamlit.delta_generatorrr__annotations__rrTr,r+r^sI#66 C9D@8-2#U2w,w,r,