streamlit-nightly 1.45.2.dev20250522__py3-none-any.whl → 1.45.2.dev20250526__py3-none-any.whl

streamlit/commands/echo.py

@@ -101,7 +101,7 @@ def echo(
         show_code(code_string, "python")
 
     except FileNotFoundError as err:
-        show_warning("Unable to display code. %s" % err)
+        show_warning(f"Unable to display code. {err}")
 
 
 def _get_initial_indent(lines: Iterable[str]) -> int:

streamlit/config.py

@@ -1301,7 +1301,8 @@ def get_where_defined(key: str) -> str:
         config_options = get_config_options()
 
         if key not in config_options:
-            raise RuntimeError('Config key "%s" not defined.' % key)
+            msg = f'Config key "{key}" not defined.'
+            raise RuntimeError(msg)
         return config_options[key].where_defined
 
 

streamlit/config_option.py

@@ -189,7 +189,7 @@ class ConfigOption:
         if self.replaced_by:
             self.deprecated = True
             if deprecation_text is None:
-                deprecation_text = "Replaced by %s." % self.replaced_by
+                deprecation_text = f"Replaced by {self.replaced_by}."
 
         if self.deprecated:
             if not expiration_date:

streamlit/config_util.py

@@ -84,7 +84,7 @@ def show_config(
             continue
 
         out.append("")
-        append_section("[%s]" % section)
+        append_section(f"[{section}]")
         out.append("")
 
         for option in section_options.values():
@@ -125,8 +125,7 @@ def show_config(
                     append_comment(line)
                 append_comment("")
                 append_comment(
-                    "This option will be removed on or after %s."
-                    % option.expiration_date
+                    f"This option will be removed on or after {option.expiration_date}."
                 )
 
             import toml
@@ -138,7 +137,7 @@ def show_config(
                 # Ensure a line break before appending "Default" comment, if not already there
                 if out[-1] != "#":
                     append_comment("")
-                append_comment("Default: %s" % toml_default)
+                append_comment(f"Default: {toml_default}")
             else:
                 # Don't say "Default: (unset)" here because this branch applies
                 # to complex config settings too.
@@ -151,7 +150,7 @@ def show_config(
             if option_is_manually_set:
                 if out[-1] != "# ":
                     append_comment("")
-                append_comment("The value below was set in %s" % option.where_defined)
+                append_comment(f"The value below was set in {option.where_defined}")
 
             toml_setting = toml.dumps({key: option.value})
 

streamlit/delta_generator.py

@@ -106,6 +106,7 @@ if TYPE_CHECKING:
 
     from streamlit.cursor import Cursor
     from streamlit.elements.lib.built_in_chart_utils import AddRowsMetadata
+    from streamlit.elements.lib.layout_utils import LayoutConfig
 
 MAX_DELTA_BYTES: Final[int] = 14 * 1024 * 1024  # 14MB
 
@@ -437,6 +438,7 @@ class DeltaGenerator(
         delta_type: str,
         element_proto: Message,
         add_rows_metadata: AddRowsMetadata | None = None,
+        layout_config: LayoutConfig | None = None,
     ) -> DeltaGenerator:
         """Create NewElement delta, fill it, and enqueue it.
 
@@ -476,6 +478,25 @@ class DeltaGenerator(
         msg_el_proto = getattr(msg.delta.new_element, delta_type)
         msg_el_proto.CopyFrom(element_proto)
 
+        if layout_config:
+            if layout_config.height:
+                if isinstance(layout_config.height, int):
+                    msg.delta.new_element.height_config.pixel_height = (
+                        layout_config.height
+                    )
+                elif layout_config.height == "content":
+                    msg.delta.new_element.height_config.use_content = True
+                else:
+                    msg.delta.new_element.height_config.use_stretch = True
+
+            if layout_config.width:
+                if isinstance(layout_config.width, int):
+                    msg.delta.new_element.width_config.pixel_width = layout_config.width
+                elif layout_config.width == "content":
+                    msg.delta.new_element.width_config.use_content = True
+                else:
+                    msg.delta.new_element.width_config.use_stretch = True
+
         # Only enqueue message and fill in metadata if there's a container.
         msg_was_enqueued = False
         if dg._root_container is not None and dg._cursor is not None:

streamlit/elements/arrow.py

@@ -908,6 +908,25 @@ def _arrow_add_rows(
         and dg._cursor.props["add_rows_metadata"].last_index is None
     ):
         st_method = getattr(dg, dg._cursor.props["add_rows_metadata"].chart_command)
+        metadata = dg._cursor.props["add_rows_metadata"]
+
+        # Pass the styling properties stored in add_rows_metadata
+        # to the new element call.
+        kwargs = {}
+        if metadata.color is not None:
+            kwargs["color"] = metadata.color
+        if metadata.width is not None:
+            kwargs["width"] = metadata.width
+        if metadata.height is not None:
+            kwargs["height"] = metadata.height
+        if metadata.stack is not None:
+            kwargs["stack"] = metadata.stack
+
+        if metadata.chart_command == "bar_chart":
+            kwargs["horizontal"] = metadata.horizontal
+
+        kwargs["use_container_width"] = metadata.use_container_width
+
         st_method(data, **kwargs)
         return None
 

streamlit/elements/code.py

@@ -16,7 +16,13 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, cast
 
-from streamlit.elements.lib.layout_utils import WidthWithoutContent, validate_width
+from streamlit.elements.lib.layout_utils import (
+    Height,
+    LayoutConfig,
+    WidthWithoutContent,
+    validate_height,
+    validate_width,
+)
 from streamlit.proto.Code_pb2 import Code as CodeProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.string_util import clean_text
@@ -35,7 +41,7 @@ class CodeMixin:
         *,
         line_numbers: bool = False,
         wrap_lines: bool = False,
-        height: int | None = None,
+        height: Height = "content",
         width: WidthWithoutContent = "stretch",
     ) -> DeltaGenerator:
         """Display a code block with optional syntax highlighting.
@@ -111,17 +117,12 @@ class CodeMixin:
         code_proto.language = language or "plaintext"
         code_proto.show_line_numbers = line_numbers
         code_proto.wrap_lines = wrap_lines
-        if height:
-            code_proto.height = height
 
-        # Set width configuration
+        validate_height(height, allow_content=True)
         validate_width(width)
-        if isinstance(width, int):
-            code_proto.width_config.pixel_width = width
-        else:
-            code_proto.width_config.use_stretch = True
+        layout_config = LayoutConfig(height=height, width=width)
 
-        return self.dg._enqueue("code", code_proto)
+        return self.dg._enqueue("code", code_proto, layout_config=layout_config)
 
     @property
     def dg(self) -> DeltaGenerator:

streamlit/elements/exception.py

@@ -237,18 +237,10 @@ def _format_syntax_error_message(exception: SyntaxError) -> str:
         )
 
         return (
-            'File "%(filename)s", line %(lineno)s\n'
-            "  %(text)s\n"
-            "  %(caret_indent)s^\n"
-            "%(errname)s: %(msg)s"
-            % {
-                "filename": exception.filename,
-                "lineno": exception.lineno,
-                "text": exception.text.rstrip(),
-                "caret_indent": caret_indent,
-                "errname": type(exception).__name__,
-                "msg": exception.msg,
-            }
+            f'File "{exception.filename}", line {exception.lineno}\n'
+            f"  {exception.text.rstrip()}\n"
+            f"  {caret_indent}^\n"
+            f"{type(exception).__name__}: {exception.msg}"
         )
     # If a few edge cases, SyntaxErrors don't have all these nice fields. So we
     # have a fall back here.

streamlit/elements/graphviz_chart.py

@@ -141,7 +141,7 @@ def marshall(
         engine = "dot"
     else:
         raise StreamlitAPIException(
-            "Unhandled type for graphviz chart: %s" % type(figure_or_dot)
+            f"Unhandled type for graphviz chart: {type(figure_or_dot)}"
         )
 
     proto.spec = dot

streamlit/elements/heading.py

@@ -286,14 +286,13 @@ class HeadingMixin:
                 proto.anchor = anchor
             elif anchor is True:  # type: ignore
                 raise StreamlitAPIException(
-                    "Anchor parameter has invalid value: %s. "
-                    "Supported values: None, any string or False" % anchor
+                    f"Anchor parameter has invalid value: {anchor}. "
+                    "Supported values: None, any string or False"
                 )
             else:
                 raise StreamlitAPIException(
-                    "Anchor parameter has invalid type: %s. "
+                    f"Anchor parameter has invalid type: {type(anchor).__name__}. "
                     "Supported values: None, any string or False"
-                    % type(anchor).__name__
                 )
 
         if help:

streamlit/elements/lib/built_in_chart_utils.py

@@ -71,6 +71,15 @@ class AddRowsMetadata:
     chart_command: str
     last_index: Hashable | None
     columns: PrepDataColumns
+    # Chart styling properties
+    color: str | Color | list[Color] | None = None
+    width: int | None = None
+    height: int | None = None
+    use_container_width: bool = True
+    # Only applicable for bar & area charts
+    stack: bool | ChartStackType | None = None
+    # Only applicable for bar charts
+    horizontal: bool = False
 
 
 class ChartType(Enum):
@@ -147,8 +156,11 @@ def generate_chart(
     size_from_user: str | float | None = None,
     width: int | None = None,
     height: int | None = None,
+    use_container_width: bool = True,
     # Bar & Area charts only:
     stack: bool | ChartStackType | None = None,
+    # Bar charts only:
+    horizontal: bool = False,
 ) -> tuple[alt.Chart | alt.LayerChart, AddRowsMetadata]:
     """Function to use the chart's type, data columns and indices to figure out the
     chart's spec.
@@ -186,6 +198,13 @@ def generate_chart(
             "color_column": color_column,
             "size_column": size_column,
         },
+        # Chart styling properties
+        color=color_from_user,
+        width=width,
+        height=height,
+        use_container_width=use_container_width,
+        stack=stack,
+        horizontal=horizontal,
     )
 
     # At this point, all foo_column variables are either None/empty or contain actual

streamlit/elements/lib/image_utils.py

@@ -160,8 +160,7 @@ def _verify_np_shape(array: npt.NDArray[Any]) -> npt.NDArray[Any]:
         raise StreamlitAPIException("Numpy shape has to be of length 2 or 3.")
     if len(shape) == 3 and shape[-1] not in (1, 3, 4):
         raise StreamlitAPIException(
-            "Channel can only be 1, 3, or 4 got %d. Shape is %s"
-            % (shape[-1], str(shape))
+            f"Channel can only be 1, 3, or 4 got {shape[-1]}. Shape is {shape}"
         )
 
     # If there's only one channel, convert is to x, y
@@ -437,7 +436,7 @@ def marshall_images(
 
         # We use the index of the image in the input image list to identify this image inside
         # MediaFileManager. For this, we just add the index to the image's "coordinates".
-        image_id = "%s-%i" % (coordinates, coord_suffix)
+        image_id = f"{coordinates}-{coord_suffix}"
 
         proto_img.url = image_to_url(
             single_image, width, clamp, channels, output_format, image_id

streamlit/elements/lib/layout_utils.py

@@ -11,15 +11,25 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
+from __future__ import annotations
 
+from dataclasses import dataclass
 from typing import Literal, Union
 
 from typing_extensions import TypeAlias
 
-from streamlit.errors import StreamlitInvalidWidthError
+from streamlit.errors import StreamlitInvalidHeightError, StreamlitInvalidWidthError
 
 WidthWithoutContent: TypeAlias = Union[int, Literal["stretch"]]
 Width: TypeAlias = Union[int, Literal["stretch", "content"]]
+HeightWithoutContent: TypeAlias = Union[int, Literal["stretch"]]
+Height: TypeAlias = Union[int, Literal["stretch", "content"]]
+
+
+@dataclass
+class LayoutConfig:
+    width: Width | None = None
+    height: Height | None = None
 
 
 def validate_width(width: Width, allow_content: bool = False) -> None:
@@ -49,3 +59,33 @@ def validate_width(width: Width, allow_content: bool = False) -> None:
             raise StreamlitInvalidWidthError(width, allow_content)
     elif width <= 0:
         raise StreamlitInvalidWidthError(width, allow_content)
+
+
+def validate_height(height: Height, allow_content: bool = False) -> None:
+    """Validate the height parameter.
+
+    Parameters
+    ----------
+    height : Any
+        The height value to validate.
+    allow_content : bool
+        Whether to allow "content" as a valid height value.
+
+    Raises
+    ------
+    StreamlitInvalidHeightError
+        If the height value is invalid.
+    """
+    if not isinstance(height, (int, str)):
+        raise StreamlitInvalidHeightError(height, allow_content)
+
+    if isinstance(height, str):
+        valid_strings = ["stretch"]
+        if allow_content:
+            valid_strings.append("content")
+
+        if height not in valid_strings:
+            raise StreamlitInvalidHeightError(height, allow_content)
+
+    elif height <= 0:
+        raise StreamlitInvalidHeightError(height, allow_content)

streamlit/elements/markdown.py

@@ -252,7 +252,7 @@ class MarkdownMixin:
             body = sympy.latex(body)
 
         latex_proto = MarkdownProto()
-        latex_proto.body = "$$\n%s\n$$" % clean_text(body)
+        latex_proto.body = f"$$\n{clean_text(body)}\n$$"
         latex_proto.element_type = MarkdownProto.Type.LATEX
         if help:
             latex_proto.help = help

streamlit/elements/media.py

@@ -478,7 +478,7 @@ def _marshall_av_media(
     elif type_util.is_type(data, "numpy.ndarray"):
         data_or_filename = cast("npt.NDArray[Any]", data).tobytes()
     else:
-        raise RuntimeError("Invalid binary data format: %s" % type(data))
+        raise RuntimeError(f"Invalid binary data format: {type(data)}")
 
     if runtime.exists():
         file_url = runtime.get_instance().media_file_mgr.add(

streamlit/elements/progress.py

@@ -66,17 +66,17 @@ def _get_value(value: FloatOrInt) -> int:
         if 0 <= value <= 100:
             return value
         raise StreamlitAPIException(
-            "Progress Value has invalid value [0, 100]: %d" % value
+            f"Progress Value has invalid value [0, 100]: {value}"
         )
 
     if isinstance(value, float):
         if _check_float_between(value, low=0.0, high=1.0):
             return int(value * 100)
         raise StreamlitAPIException(
-            "Progress Value has invalid value [0.0, 1.0]: %f" % value
+            f"Progress Value has invalid value [0.0, 1.0]: {value}"
         )
     raise StreamlitAPIException(
-        "Progress Value has invalid type: %s" % type(value).__name__
+        f"Progress Value has invalid type: {type(value).__name__}"
     )
 
 

streamlit/elements/vega_charts.py

@@ -742,6 +742,7 @@ class VegaChartsMixin:
             size_from_user=None,
             width=width,
             height=height,
+            use_container_width=use_container_width,
         )
         return cast(
             "DeltaGenerator",
@@ -983,6 +984,7 @@ class VegaChartsMixin:
             width=width,
             height=height,
             stack=stack,
+            use_container_width=use_container_width,
         )
         return cast(
             "DeltaGenerator",
@@ -1248,7 +1250,9 @@ class VegaChartsMixin:
             size_from_user=None,
             width=width,
             height=height,
+            use_container_width=use_container_width,
             stack=stack,
+            horizontal=horizontal,
         )
         return cast(
             "DeltaGenerator",
@@ -1459,6 +1463,7 @@ class VegaChartsMixin:
             size_from_user=size,
             width=width,
             height=height,
+            use_container_width=use_container_width,
         )
         return cast(
             "DeltaGenerator",

streamlit/elements/widgets/button.py

@@ -1105,7 +1105,7 @@ def marshall_file(
         data_as_bytes = data.read() or b""
         mimetype = mimetype or "application/octet-stream"
     else:
-        raise StreamlitAPIException("Invalid binary data format: %s" % type(data))
+        raise StreamlitAPIException(f"Invalid binary data format: {type(data)}")
 
     if runtime.exists():
         file_url = runtime.get_instance().media_file_mgr.add(

streamlit/elements/widgets/color_picker.py

@@ -206,25 +206,19 @@ class ColorPickerMixin:
 
         # make sure the value is a string
         if not isinstance(value, str):
-            raise StreamlitAPIException(
-                """
-                Color Picker Value has invalid type: %s. Expects a hex string
-                like '#00FFAA' or '#000'.
-                """
-                % type(value).__name__
-            )
+            raise StreamlitAPIException(f"""
+Color Picker Value has invalid type: {type(value).__name__}. Expects a hex string
+like '#00FFAA' or '#000'.
+""")
 
         # validate the value and expects a hex string
         match = re.match(r"^#(?:[0-9a-fA-F]{3}){1,2}$", value)
 
         if not match:
-            raise StreamlitAPIException(
-                """
-                '%s' is not a valid hex code for colors. Valid ones are like
-                '#00FFAA' or '#000'.
-                """
-                % value
-            )
+            raise StreamlitAPIException(f"""
+'{value}' is not a valid hex code for colors. Valid ones are like
+'#00FFAA' or '#000'.
+""")
 
         color_picker_proto = ColorPickerProto()
         color_picker_proto.id = element_id

streamlit/elements/widgets/radio.py

@@ -351,7 +351,7 @@ class RadioMixin:
 
         if not isinstance(index, int) and index is not None:
             raise StreamlitAPIException(
-                "Radio Value has invalid type: %s" % type(index).__name__
+                f"Radio Value has invalid type: {type(index).__name__}"
             )
 
         if index is not None and len(opt) > 0 and not 0 <= index < len(opt):

streamlit/elements/widgets/selectbox.py

@@ -495,7 +495,7 @@ class SelectboxMixin:
 
         if not isinstance(index, int) and index is not None:
             raise StreamlitAPIException(
-                "Selectbox Value has invalid type: %s" % type(index).__name__
+                f"Selectbox Value has invalid type: {type(index).__name__}"
             )
 
         if index is not None and len(opt) > 0 and not 0 <= index < len(opt):

streamlit/elements/widgets/slider.py

@@ -813,17 +813,13 @@ class SliderMixin:
         )
 
         if not int_args and not float_args and not timelike_args:
-            raise StreamlitAPIException(
+            msg = (
                 "Slider value arguments must be of matching types."
-                "\n`min_value` has %(min_type)s type."
-                "\n`max_value` has %(max_type)s type."
-                "\n`step` has %(step)s type."
-                % {
-                    "min_type": type(min_value).__name__,
-                    "max_type": type(max_value).__name__,
-                    "step": type(step).__name__,
-                }
+                f"\n`min_value` has {type(min_value).__name__} type."
+                f"\n`max_value` has {type(max_value).__name__} type."
+                f"\n`step` has {type(step).__name__} type."
             )
+            raise StreamlitAPIException(msg)
 
         # Ensure that the value matches arguments' types.
         all_ints = data_type == SliderProto.INT and int_args
@@ -831,17 +827,13 @@ class SliderMixin:
         all_timelikes = data_type in TIMELIKE_TYPES and timelike_args
 
         if not all_ints and not all_floats and not all_timelikes:
-            raise StreamlitAPIException(
+            msg = (
                 "Both value and arguments must be of the same type."
-                "\n`value` has %(value_type)s type."
-                "\n`min_value` has %(min_type)s type."
-                "\n`max_value` has %(max_type)s type."
-                % {
-                    "value_type": type(value).__name__,
-                    "min_type": type(min_value).__name__,
-                    "max_type": type(max_value).__name__,
-                }
+                f"\n`value` has {type(value).__name__} type."
+                f"\n`min_value` has {type(min_value).__name__} type."
+                f"\n`max_value` has {type(max_value).__name__} type."
             )
+            raise StreamlitAPIException(msg)
 
         # Ensure that min <= value(s) <= max, adjusting the bounds as necessary.
         min_value = min(min_value, max_value)

streamlit/elements/widgets/text_widgets.py

@@ -369,8 +369,7 @@ class TextWidgetsMixin:
             text_input_proto.type = TextInputProto.PASSWORD
         else:
             raise StreamlitAPIException(
-                "'%s' is not a valid text_input type. Valid types are 'default' and 'password'."
-                % type
+                f"'{type}' is not a valid text_input type. Valid types are 'default' and 'password'."
             )
 
         # Marshall the autocomplete param. If unspecified, this will be

streamlit/errors.py

@@ -480,3 +480,18 @@ class StreamlitInvalidWidthError(LocalizableStreamlitException):
             width=repr(width),
             valid_values=valid_values,
         )
+
+
+class StreamlitInvalidHeightError(LocalizableStreamlitException):
+    """Exception raised when an invalid height value is provided."""
+
+    def __init__(self, height: Any, allow_content: bool = False) -> None:
+        valid_values = "an integer (pixels) or 'stretch'"
+        if allow_content:
+            valid_values = "an integer (pixels), 'stretch', or 'content'"
+
+        super().__init__(
+            "Invalid height value: {height}. Height must be either {valid_values}.",
+            height=repr(height),
+            valid_values=valid_values,
+        )

streamlit/hello/animation_demo.py

@@ -42,7 +42,7 @@ def animation_demo() -> None:
     for frame_num, a in enumerate(np.linspace(0.0, 4 * np.pi, 100)):
         # Here were setting value for these two elements.
         progress_bar.progress(frame_num)
-        frame_text.text("Frame %i/100" % (frame_num + 1))
+        frame_text.text(f"Frame {frame_num + 1}/100")
 
         # Performing some fractal wizardry.
         c = separation * np.exp(1j * a)

streamlit/hello/mapping_demo.py

@@ -26,7 +26,7 @@ def mapping_demo() -> None:
     def from_data_file(filename: str) -> pd.DataFrame:
         url = (
             "https://raw.githubusercontent.com/streamlit/"
-            "example-data/master/hello/v1/%s" % filename
+            f"example-data/master/hello/v1/{filename}"
         )
         return pd.read_json(url)
 
@@ -95,11 +95,10 @@ def mapping_demo() -> None:
             st.error("Please choose at least one layer above.")
     except URLError as e:
         st.error(
-            """
+            f"""
             **This demo requires internet access.**
-            Connection error: %s
+            Connection error: {e.reason}
         """
-            % e.reason
         )
 
 

streamlit/logger.py

@@ -46,7 +46,7 @@ def set_log_level(level: str | int) -> None:
     elif level in {"DEBUG", logging.DEBUG}:
         log_level = logging.DEBUG
     else:
-        msg = 'undefined log level "%s"' % level
+        msg = f'undefined log level "{level}"'
         logger.critical(msg)
         sys.exit(1)