streamlit-nightly 1.36.1.dev20240626__py2.py3-none-any.whl → 1.36.1.dev20240628__py2.py3-none-any.whl

streamlit/commands/page_config.py

@@ -154,13 +154,13 @@ def set_page_config(
           to set a random emoji from the supported list above. Emoji icons are
           courtesy of Twemoji and loaded from MaxCDN.
 
-        * An icon from the Material Symbols library (outlined style) in the
+        * 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=Outlined>`_
+          <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
           font library.
 
         .. note::

streamlit/components/v1/components.py

@@ -20,6 +20,6 @@
 # model the old behavior and not to break things.
 
 from streamlit.components.v1.component_registry import (
-    declare_component as declare_component,
+    declare_component as declare_component,  # noqa: PLC0414
 )
 from streamlit.components.v1.custom_component import *  # noqa: F403

streamlit/elements/alert.py

@@ -53,7 +53,7 @@ class AlertMixin:
 
               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=Outlined>`_
+              <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
 
         Example
@@ -91,7 +91,7 @@ class AlertMixin:
             * 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 (outlined style) in the
+            * 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.
 

streamlit/elements/graphviz_chart.py

@@ -32,7 +32,9 @@ if TYPE_CHECKING:
 
     from streamlit.delta_generator import DeltaGenerator
 
-FigureOrDot: TypeAlias = Union["graphviz.Graph", "graphviz.Digraph", str]
+FigureOrDot: TypeAlias = Union[
+    "graphviz.Graph", "graphviz.Digraph", "graphviz.Source", str
+]
 
 
 class GraphvizMixin:
@@ -46,7 +48,7 @@ class GraphvizMixin:
 
         Parameters
         ----------
-        figure_or_dot : graphviz.dot.Graph, graphviz.dot.Digraph, str
+        figure_or_dot : graphviz.dot.Graph, graphviz.dot.Digraph, graphviz.sources.Source, str
             The Graphlib graph object or dot string to display
 
         use_container_width : bool

streamlit/elements/layouts.py

@@ -503,13 +503,13 @@ class LayoutsMixin:
             * 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 (outlined style) in the
+            * 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=Outlined>`_
+              <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
 
         Examples

streamlit/elements/lib/built_in_chart_utils.py

@@ -45,7 +45,7 @@ if TYPE_CHECKING:
     import pandas as pd
 
     from streamlit.elements.arrow import Data
-    from streamlit.type_util import DataFrameCompatible
+    from streamlit.type_util import ChartStackType, DataFrameCompatible
 
 
 class PrepDataColumns(TypedDict):
@@ -123,6 +123,8 @@ def generate_chart(
     size_from_user: str | float | None = None,
     width: int | None = None,
     height: int | None = None,
+    # Bar charts only:
+    stack: bool | ChartStackType | None = None,
 ) -> tuple[alt.Chart, AddRowsMetadata]:
     """Function to use the chart's type, data columns and indices to figure out the chart's spec."""
     import altair as alt
@@ -166,21 +168,18 @@ def generate_chart(
 
     # At this point, x_column is only None if user did not provide one AND df is empty.
 
-    if chart_type == ChartType.HORIZONTAL_BAR:
-        # Handle horizontal bar chart - switches x and y data:
-        x_encoding = _get_x_encoding(
-            df, y_column, y_from_user, x_axis_label, chart_type
-        )
-        y_encoding = _get_y_encoding(
-            df, x_column, x_from_user, y_axis_label, chart_type
-        )
-    else:
-        x_encoding = _get_x_encoding(
-            df, x_column, x_from_user, x_axis_label, chart_type
-        )
-        y_encoding = _get_y_encoding(
-            df, y_column, y_from_user, y_axis_label, chart_type
-        )
+    # Get x and y encodings
+    x_encoding, y_encoding = _get_axis_encodings(
+        df,
+        chart_type,
+        x_column,
+        y_column,
+        x_from_user,
+        y_from_user,
+        x_axis_label,
+        y_axis_label,
+        stack,
+    )
 
     # Create a Chart with x and y encodings.
     chart = alt.Chart(
@@ -193,8 +192,21 @@ def generate_chart(
         y=y_encoding,
     )
 
+    # Offset encoding only works for Altair >= 5.0.0
+    is_altair_version_offset_compatible = not type_util.is_altair_version_less_than(
+        "5.0.0"
+    )
+    # Set up offset encoding (creates grouped/non-stacked bar charts, so only applicable when stack=False).
+    if (
+        is_altair_version_offset_compatible
+        and stack is False
+        and color_column is not None
+    ):
+        x_offset, y_offset = _get_offset_encoding(chart_type, color_column)
+        chart = chart.encode(xOffset=x_offset, yOffset=y_offset)
+
     # Set up opacity encoding.
-    opacity_enc = _get_opacity_encoding(chart_type, color_column)
+    opacity_enc = _get_opacity_encoding(chart_type, stack, color_column)
     if opacity_enc is not None:
         chart = chart.encode(opacity=opacity_enc)
 
@@ -484,7 +496,7 @@ def _maybe_convert_color_column_in_place(df: pd.DataFrame, color_column: str | N
         pass
     elif is_color_tuple_like(first_color_datum):
         # Tuples need to be converted to CSS-valid.
-        df[color_column] = df[color_column].map(to_css_color)
+        df.loc[:, color_column] = df[color_column].map(to_css_color)
     else:
         # Other kinds of colors columns (i.e. pure numbers or nominal strings) shouldn't
         # be converted since they are treated by Vega-Lite as sequential or categorical colors.
@@ -577,14 +589,38 @@ def _parse_y_columns(
     return y_column_list
 
 
+def _get_offset_encoding(
+    chart_type: ChartType,
+    color_column: str | None,
+) -> tuple[alt.XOffset, alt.YOffset]:
+    # Vega's Offset encoding channel is used to create grouped/non-stacked bar charts
+    import altair as alt
+
+    x_offset = alt.XOffset()
+    y_offset = alt.YOffset()
+
+    if chart_type is ChartType.VERTICAL_BAR:
+        x_offset = alt.XOffset(field=color_column)
+    elif chart_type is ChartType.HORIZONTAL_BAR:
+        y_offset = alt.YOffset(field=color_column)
+
+    return x_offset, y_offset
+
+
 def _get_opacity_encoding(
-    chart_type: ChartType, color_column: str | None
+    chart_type: ChartType,
+    stack: bool | ChartStackType | None,
+    color_column: str | None,
 ) -> alt.OpacityValue | None:
     import altair as alt
 
     if color_column and chart_type == ChartType.AREA:
         return alt.OpacityValue(0.7)
 
+    # Layered bar chart
+    if color_column and stack == "layered":
+        return alt.OpacityValue(0.7)
+
     return None
 
 
@@ -634,6 +670,42 @@ def _maybe_melt(
     return df, y_column, color_column
 
 
+def _get_axis_encodings(
+    df: pd.DataFrame,
+    chart_type: ChartType,
+    x_column: str | None,
+    y_column: str | None,
+    x_from_user: str | None,
+    y_from_user: str | Sequence[str] | None,
+    x_axis_label: str | None,
+    y_axis_label: str | None,
+    stack: bool | ChartStackType | None,
+) -> tuple[alt.X, alt.Y]:
+    stack_encoding: alt.X | alt.Y
+    if chart_type == ChartType.HORIZONTAL_BAR:
+        # Handle horizontal bar chart - switches x and y data:
+        x_encoding = _get_x_encoding(
+            df, y_column, y_from_user, x_axis_label, chart_type
+        )
+        y_encoding = _get_y_encoding(
+            df, x_column, x_from_user, y_axis_label, chart_type
+        )
+        stack_encoding = x_encoding
+    else:
+        x_encoding = _get_x_encoding(
+            df, x_column, x_from_user, x_axis_label, chart_type
+        )
+        y_encoding = _get_y_encoding(
+            df, y_column, y_from_user, y_axis_label, chart_type
+        )
+        stack_encoding = y_encoding
+
+    # Handle stacking - only relevant for bar charts
+    _update_encoding_with_stack(stack, stack_encoding)
+
+    return x_encoding, y_encoding
+
+
 def _get_x_encoding(
     df: pd.DataFrame,
     x_column: str | None,
@@ -730,6 +802,19 @@ def _get_y_encoding(
     )
 
 
+def _update_encoding_with_stack(
+    stack: bool | ChartStackType | None,
+    encoding: alt.X | alt.Y,
+) -> None:
+    if stack is None:
+        return None
+    # Our layered option maps to vega's stack=False option
+    elif stack == "layered":
+        stack = False
+
+    encoding["stack"] = stack
+
+
 def _get_color_encoding(
     df: pd.DataFrame,
     color_value: Color | None,

streamlit/elements/toast.py

@@ -82,13 +82,13 @@ class ToastMixin:
             * 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 (outlined style) in the
+            * 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=Outlined>`_
+              <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
 
         Example

streamlit/elements/vega_charts.py

@@ -57,7 +57,7 @@ from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner import get_script_run_ctx
 from streamlit.runtime.state import register_widget
 from streamlit.runtime.state.common import compute_widget_id
-from streamlit.type_util import Key, to_key
+from streamlit.type_util import ChartStackType, Key, to_key
 from streamlit.util import HASHLIB_KWARGS
 
 if TYPE_CHECKING:
@@ -957,6 +957,7 @@ class VegaChartsMixin:
         y_label: str | None = None,
         color: str | Color | list[Color] | None = None,
         horizontal: bool = False,
+        stack: bool | ChartStackType | None = None,
         width: int | None = None,
         height: int | None = None,
         use_container_width: bool = True,
@@ -1046,6 +1047,14 @@ class VegaChartsMixin:
             Streamlit swaps the x-axis and y-axis and the bars display
             horizontally.
 
+        stack : bool, "normalize", "center", "layered", or None
+            Whether to stack the bars. If this is ``None`` (default), uses Vega's
+            default. If this is ``True``, the bars are stacked on top of each other.
+            If this is ``False``, the bars are displayed side by side. If "normalize",
+            the bars are stacked and normalized to 100%. If "center", the bars are
+            stacked around a central axis. If "layered", the bars are stacked on top
+            of one another.
+
         width : int or None
             Desired width of the chart expressed in pixels. If ``width`` is
             ``None`` (default), Streamlit sets the width of the chart to fit
@@ -1139,6 +1148,20 @@ class VegaChartsMixin:
 
         """
 
+        # Offset encodings (used for non-stacked/grouped bar charts) are not supported in Altair < 5.0.0
+        if type_util.is_altair_version_less_than("5.0.0") and stack is False:
+            raise StreamlitAPIException(
+                "Streamlit does not support non-stacked (grouped) bar charts with Altair 4.x. Please upgrade to Version 5."
+            )
+
+        # Check that the stack parameter is valid, raise more informative error message if not
+        VALID_STACK_TYPES = (None, True, False, "normalize", "center", "layered")
+        if stack not in VALID_STACK_TYPES:
+            raise StreamlitAPIException(
+                f'Invalid value for stack parameter: {stack}. Stack must be one of True, False, "normalize", "center", "layered" or None. '
+                "See documentation for `st.bar_chart` [here](https://docs.streamlit.io/develop/api-reference/charts/st.bar_chart) for more information."
+            )
+
         bar_chart_type = (
             ChartType.HORIZONTAL_BAR if horizontal else ChartType.VERTICAL_BAR
         )
@@ -1154,6 +1177,7 @@ class VegaChartsMixin:
             size_from_user=None,
             width=width,
             height=height,
+            stack=stack,
         )
         return cast(
             "DeltaGenerator",

streamlit/elements/widgets/button.py

@@ -522,13 +522,13 @@ class ButtonMixin:
             * 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 (outlined style) in the
+            * 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=Outlined>`_
+              <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
         help : str
             An optional tooltip that gets displayed when the link is

streamlit/elements/widgets/chat.py

@@ -167,13 +167,13 @@ class ChatMixin:
             * A single-character emoji. For example, you can set ``avatar="🧑‍💻"``
               or ``avatar="🦖"``. Emoji short codes are not supported.
 
-            * An icon from the Material Symbols library (outlined style) in the
+            * 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=Outlined>`_
+              <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
 
         Returns