streamlit-nightly 1.43.2.dev20250310__py3-none-any.whl → 1.43.3.dev20250312__py3-none-any.whl

streamlit/__init__.py

@@ -166,6 +166,7 @@ altair_chart = _main.altair_chart
 area_chart = _main.area_chart
 audio = _main.audio
 audio_input = _main.audio_input
+badge = _main.badge
 balloons = _main.balloons
 bar_chart = _main.bar_chart
 bokeh_chart = _main.bokeh_chart

streamlit/config.py

@@ -1055,6 +1055,15 @@ _create_option(
     visibility="hidden",
 )
 
+_create_option(
+    "theme.headingFont",
+    description="""
+        The font family to use for headings in the app.
+        To use a custom font, it needs to be added via [theme.fontFaces].
+    """,
+    visibility="hidden",
+)
+
 _create_option(
     "theme.fontFaces",
     description="""

streamlit/elements/markdown.py

@@ -14,11 +14,11 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Final, cast
+from typing import TYPE_CHECKING, Final, Literal, cast
 
 from streamlit.proto.Markdown_pb2 import Markdown as MarkdownProto
 from streamlit.runtime.metrics_util import gather_metrics
-from streamlit.string_util import clean_text
+from streamlit.string_util import clean_text, validate_icon_or_emoji
 from streamlit.type_util import SupportsStr, is_sympy_expression
 
 if TYPE_CHECKING:
@@ -80,8 +80,14 @@ class MarkdownMixin:
               primary accent color unless you set the ``theme.primaryColor``
               configuration option.
 
+            - Colored badges, using the syntax ``:color-badge[text in the badge]``.
+              Supported colors are: blue, green, orange, red, 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
@@ -271,6 +277,96 @@ class MarkdownMixin:
         divider_proto.element_type = MarkdownProto.Type.DIVIDER
         return self.dg._enqueue("markdown", divider_proto)
 
+    @gather_metrics("badge")
+    def badge(
+        self,
+        label: str,
+        *,  # keyword-only arguments:
+        icon: str | None = None,
+        color: Literal[
+            "blue",
+            "green",
+            "orange",
+            "red",
+            "violet",
+            "gray",
+            "grey",
+            "rainbow",
+            "primary",
+        ] = "blue",
+    ) -> DeltaGenerator:
+        """Display a colored badge with an icon and label.
+
+        You can also insert badges directly in Markdown, e.g. via
+        `st.markdown(":blue-badge[Home]")`. This works in all places where Streamlit
+        supports Markdown, e.g. widget labels or `st.table` cells. 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.
+
+            .. |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 \
+              <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
+              font library.
+
+        color : str
+            The color to use for the badge. Supported colors are: blue, green,
+            orange, red, violet, gray/grey, primary.
+            If you use "primary" for color, Streamlit will use the default
+            primary accent color unless you set the ``theme.primaryColor``
+            configuration option.
+
+        Examples
+        --------
+        >>> import streamlit as st
+        >>>
+        >>> # Simple badge
+        >>> st.badge("Home")
+        >>>
+        >>> # Badge with icon and color
+        >>> st.badge("Success", icon=":material/check:", color="green")
+        >>>
+        >>> # Multiple badges side by side in Markdown
+        >>> st.markdown(
+        ...     "Here are some badges: :orange-badge[⭐️ Favorite] :blue-badge[🏠 Home] :green-badge[✅ Success]"
+        ... )
+        """
+        if icon is not None:
+            icon_str = validate_icon_or_emoji(icon) + " "
+        else:
+            icon_str = ""
+
+        # Escape [ and ] characters in the label to prevent breaking the directive syntax
+        escaped_label = label.replace("[", "\\[").replace("]", "\\]")
+
+        badge_proto = MarkdownProto()
+        badge_proto.body = f":{color}-badge[{icon_str}{escaped_label}]"
+        badge_proto.element_type = MarkdownProto.Type.NATIVE
+        return self.dg._enqueue("markdown", badge_proto)
+
     @property
     def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""

streamlit/errors.py

@@ -450,3 +450,10 @@ class StreamlitBadTimeStringError(LocalizableStreamlitException):
             "`'1d2h34m'` or `2 days`, for example. Got: {time_string}",
             time_string=time_string,
         )
+
+
+class StreamlitSecretNotFoundError(LocalizableStreamlitException, FileNotFoundError):
+    """Exception raised when a secret cannot be found or parsed in the secrets.toml file."""
+
+    def __init__(self, message: str):
+        super().__init__(message)