streamlit-nightly 1.45.2.dev20250602__py3-none-any.whl → 1.45.2.dev20250605__py3-none-any.whl

streamlit/config.py

@@ -54,6 +54,9 @@ _config_options_template: dict[str, ConfigOption] = OrderedDict()
 # Stores the current state of config options.
 _config_options: dict[str, ConfigOption] | None = None
 
+# Stores the path to the main script. This is used to
+# resolve config and secret files relative to the main script:
+_main_script_path: str | None = None
 
 # Indicates that a config option was defined by the user.
 _USER_DEFINED: Final = "<user defined>"
@@ -243,6 +246,7 @@ def _create_option(
     replaced_by: str | None = None,
     type_: type = str,
     sensitive: bool = False,
+    multiple: bool = False,
 ) -> ConfigOption:
     '''Create a ConfigOption and store it globally in this module.
 
@@ -291,6 +295,7 @@ def _create_option(
         replaced_by=replaced_by,
         type_=type_,
         sensitive=sensitive,
+        multiple=multiple,
     )
     if option.section not in _section_descriptions:
         raise RuntimeError(
@@ -384,6 +389,7 @@ _create_option(
 
 
 @_create_option("global.developmentMode", visibility="hidden", type_=bool)
+@util.memoize
 def _global_development_mode() -> bool:
     """Are we in development mode.
 
@@ -492,6 +498,7 @@ def _logger_message_format() -> str:
     type_=bool,
     scriptable=True,
 )
+@util.memoize
 def _logger_enable_rich() -> bool:
     """
     Controls whether uncaught app exceptions are logged via the rich library.
@@ -677,6 +684,7 @@ _create_option(
         Note: This is a list of absolute paths.
     """,
     default_val=[],
+    multiple=True,
 )
 
 _create_option(
@@ -689,6 +697,7 @@ _create_option(
         Example: ['/home/user1/env', 'relative/path/to/folder']
     """,
     default_val=[],
+    multiple=True,
 )
 
 _create_option(
@@ -774,8 +783,6 @@ _create_option(
     "server.port",
     description="""
         The port where the server will listen for browser connections.
-
-        Don't use port 3000 which is reserved for internal development.
     """,
     default_val=8501,
     type_=int,
@@ -831,6 +838,7 @@ _create_option(
         Example: ['http://example.com', 'https://streamlit.io']
     """,
     default_val=[],
+    multiple=True,
 )
 
 _create_option(
@@ -954,8 +962,7 @@ def _browser_server_port() -> int:
     - Open the browser automatically (part of `streamlit run`).
 
     This option is for advanced use cases. To change the port of your app, use
-    `server.Port` instead. Don't use port 3000 which is reserved for internal
-    development.
+    `server.Port` instead.
 
     Default: whatever value is set in server.port.
     """
@@ -1020,6 +1027,7 @@ _create_option(
         to pass the Mapbox API token.
     """,
     default_val="",
+    type_=str,
     sensitive=True,
     deprecated=True,
     deprecation_text="""
@@ -1251,6 +1259,14 @@ _create_theme_options(
     """,
 )
 
+_create_theme_options(
+    "dataframeBorderColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
+    description="""
+        The color of the border around dataframes and tables.
+    """,
+)
+
 _create_theme_options(
     "showWidgetBorder",
     categories=["theme", CustomThemeCategories.SIDEBAR],
@@ -1287,23 +1303,17 @@ _create_theme_options(
 
 _create_section("secrets", "Secrets configuration.")
 
-_create_option(
-    "secrets.files",
-    description="""
-        List of locations where secrets are searched.
 
-        An entry can be a path to a TOML file or directory path where
-        Kubernetes style secrets are saved. Order is important, import is
-        first to last, so secrets in later files will take precedence over
-        earlier ones.
-    """,
-    default_val=[
-        # NOTE: The order here is important! Project-level secrets should overwrite
-        # global secrets.
-        file_util.get_streamlit_file_path("secrets.toml"),
-        file_util.get_project_streamlit_file_path("secrets.toml"),
-    ],
-)
+@_create_option("secrets.files", multiple=True)
+def _secrets_files() -> list[str]:
+    """List of locations where secrets are searched.
+
+    An entry can be a path to a TOML file or directory path where
+    Kubernetes style secrets are saved. Order is important, import is
+    first to last, so secrets in later files will take precedence over
+    earlier ones.
+    """
+    return get_config_files("secrets.toml")
 
 
 def get_where_defined(key: str) -> str:
@@ -1553,10 +1563,30 @@ def _maybe_convert_to_number(v: Any) -> Any:
 # something.
 _on_config_parsed = Signal(doc="Emitted when the config file is parsed.")
 
-CONFIG_FILENAMES = [
-    file_util.get_streamlit_file_path("config.toml"),
-    file_util.get_project_streamlit_file_path("config.toml"),
-]
+
+def get_config_files(file_name: str) -> list[str]:
+    """Return the list of config files (e.g. config.toml or secrets.toml) to be parsed.
+
+    Order is important, import is first to last, so options in later files
+    will take precedence over earlier ones.
+    """
+    # script-level config files overwrite project-level config
+    # files, which in turn overwrite global config files.
+    config_files = [
+        file_util.get_streamlit_file_path(file_name),
+        file_util.get_project_streamlit_file_path(file_name),
+    ]
+
+    if _main_script_path is not None:
+        script_level_config = file_util.get_main_script_streamlit_file_path(
+            _main_script_path, file_name
+        )
+        if script_level_config not in config_files:
+            # We need to append the script-level config file to the list
+            # so that it overwrites project & global level config files:
+            config_files.append(script_level_config)
+
+    return config_files
 
 
 def get_config_options(
@@ -1607,7 +1637,7 @@ def get_config_options(
 
         # Values set in files later in the CONFIG_FILENAMES list overwrite those
         # set earlier.
-        for filename in CONFIG_FILENAMES:
+        for filename in get_config_files("config.toml"):
             if not os.path.exists(filename):
                 continue
 
@@ -1643,7 +1673,7 @@ def _check_conflicts() -> None:
     # When using the Node server, we must always connect to 8501 (this is
     # hard-coded in JS). Otherwise, the browser would decide what port to
     # connect to based on window.location.port, which in dev is going
-    # to be (3000)
+    # to be 3000.
 
     # Import logger locally to prevent circular references
     from streamlit.logger import get_logger

streamlit/config_option.py

@@ -108,6 +108,7 @@ class ConfigOption:
         replaced_by: str | None = None,
         type_: type = str,
         sensitive: bool = False,
+        multiple: bool = False,
     ) -> None:
         """Create a ConfigOption with the given name.
 
@@ -142,6 +143,8 @@ class ConfigOption:
             Useful to cast the config params sent by cmd option parameter.
         sensitive: bool
             Sensitive configuration options cannot be set by CLI parameter.
+        multiple: bool
+            Whether this config option can have multiple values.
         """
         # Parse out the section and name.
         self.key = key
@@ -183,8 +186,7 @@ class ConfigOption:
         self.where_defined = ConfigOption.DEFAULT_DEFINITION
         self.type = type_
         self.sensitive = sensitive
-        # infer multiple values if the default value is a list or tuple
-        self.multiple = isinstance(default_val, (list, tuple))
+        self.multiple = multiple
 
         if self.replaced_by:
             self.deprecated = True

streamlit/elements/arrow.py

@@ -37,7 +37,6 @@ from streamlit.elements.lib.column_config_utils import (
     process_config_mapping,
     update_column_config,
 )
-from streamlit.elements.lib.event_utils import AttributeDictionary
 from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.pandas_styler_utils import marshall_styler
 from streamlit.elements.lib.policies import check_widget_policies
@@ -51,6 +50,7 @@ from streamlit.runtime.scriptrunner_utils.script_run_context import (
     get_script_run_ctx,
 )
 from streamlit.runtime.state import WidgetCallback, register_widget
+from streamlit.util import AttributeDictionary
 
 if TYPE_CHECKING:
     from collections.abc import Hashable, Iterable
@@ -823,9 +823,7 @@ def _prep_data_for_add_rows(
 def _arrow_add_rows(
     dg: DeltaGenerator,
     data: Data = None,
-    **kwargs: (
-        DataFrame | npt.NDArray[Any] | Iterable[Any] | dict[Hashable, Any] | None
-    ),
+    **kwargs: DataFrame | npt.NDArray[Any] | Iterable[Any] | dict[Hashable, Any] | None,
 ) -> DeltaGenerator | None:
     """Concatenate a dataframe to the bottom of the current one.
 

streamlit/elements/deck_gl_json_chart.py

@@ -29,7 +29,6 @@ from typing import (
 from typing_extensions import TypeAlias
 
 from streamlit import config
-from streamlit.elements.lib.event_utils import AttributeDictionary
 from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.policies import check_widget_policies
 from streamlit.elements.lib.utils import Key, compute_and_register_element_id, to_key
@@ -41,6 +40,7 @@ from streamlit.runtime.state import (
     WidgetCallback,
     register_widget,
 )
+from streamlit.util import AttributeDictionary
 
 if TYPE_CHECKING:
     from collections.abc import Iterable, Mapping

streamlit/elements/heading.py

@@ -19,6 +19,7 @@ from typing import TYPE_CHECKING, Literal, Union, cast
 
 from typing_extensions import TypeAlias
 
+from streamlit.elements.lib.layout_utils import LayoutConfig, validate_width
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.Heading_pb2 import Heading as HeadingProto
 from streamlit.runtime.metrics_util import gather_metrics
@@ -26,6 +27,7 @@ from streamlit.string_util import clean_text
 
 if TYPE_CHECKING:
     from streamlit.delta_generator import DeltaGenerator
+    from streamlit.elements.lib.layout_utils import Width
     from streamlit.type_util import SupportsStr
 
 
@@ -48,6 +50,7 @@ class HeadingMixin:
         *,  # keyword-only arguments:
         help: str | None = None,
         divider: Divider = False,
+        width: Width = "stretch",
     ) -> DeltaGenerator:
         """Display text in header formatting.
 
@@ -84,6 +87,11 @@ class HeadingMixin:
             the following: blue, green, orange, red, violet, gray/grey, or
             rainbow.
 
+        width : int or "stretch" or "content"
+            The width of the header. Can be an integer (pixels), "stretch" to
+            use the full width of the container, or "content" (default) to size
+            based on the content.
+
         Examples
         --------
         >>> import streamlit as st
@@ -101,6 +109,9 @@ class HeadingMixin:
            height: 600px
 
         """
+        validate_width(width, allow_content=True)
+        layout_config = LayoutConfig(width=width)
+
         return self.dg._enqueue(
             "heading",
             HeadingMixin._create_heading_proto(
@@ -110,6 +121,7 @@ class HeadingMixin:
                 help=help,
                 divider=divider,
             ),
+            layout_config=layout_config,
         )
 
     @gather_metrics("subheader")
@@ -120,6 +132,7 @@ class HeadingMixin:
         *,  # keyword-only arguments:
         help: str | None = None,
         divider: Divider = False,
+        width: Width = "stretch",
     ) -> DeltaGenerator:
         """Display text in subheader formatting.
 
@@ -156,6 +169,11 @@ class HeadingMixin:
             the following: blue, green, orange, red, violet, gray/grey, or
             rainbow.
 
+        width : int or "stretch" or "content"
+            The width of the subheader. Can be an integer (pixels), "stretch" to
+            use the full width of the container, or "content" (default) to size
+            based on the content.
+
         Examples
         --------
         >>> import streamlit as st
@@ -173,6 +191,9 @@ class HeadingMixin:
            height: 500px
 
         """
+        validate_width(width, allow_content=True)
+        layout_config = LayoutConfig(width=width)
+
         return self.dg._enqueue(
             "heading",
             HeadingMixin._create_heading_proto(
@@ -182,6 +203,7 @@ class HeadingMixin:
                 help=help,
                 divider=divider,
             ),
+            layout_config=layout_config,
         )
 
     @gather_metrics("title")
@@ -191,6 +213,7 @@ class HeadingMixin:
         anchor: Anchor = None,
         *,  # keyword-only arguments:
         help: str | None = None,
+        width: Width = "stretch",
     ) -> DeltaGenerator:
         """Display text in title formatting.
 
@@ -222,6 +245,11 @@ class HeadingMixin:
             including the Markdown directives described in the ``body``
             parameter of ``st.markdown``.
 
+        width : int or "stretch" or "content"
+            The width of the title. Can be an integer (pixels), "stretch" to
+            use the full width of the container, or "content" (default) to size
+            based on the content.
+
         Examples
         --------
         >>> import streamlit as st
@@ -234,11 +262,15 @@ class HeadingMixin:
            height: 220px
 
         """
+        validate_width(width, allow_content=True)
+        layout_config = LayoutConfig(width=width)
+
         return self.dg._enqueue(
             "heading",
             HeadingMixin._create_heading_proto(
                 tag=HeadingProtoTag.TITLE_TAG, body=body, anchor=anchor, help=help
             ),
+            layout_config=layout_config,
         )
 
     @property

streamlit/elements/metric.py

@@ -20,6 +20,7 @@ from typing import TYPE_CHECKING, Any, Literal, Union, cast
 
 from typing_extensions import TypeAlias
 
+from streamlit.elements.lib.layout_utils import LayoutConfig, Width, validate_width
 from streamlit.elements.lib.policies import maybe_raise_label_warnings
 from streamlit.elements.lib.utils import (
     LabelVisibility,
@@ -58,6 +59,7 @@ class MetricMixin:
         help: str | None = None,
         label_visibility: LabelVisibility = "visible",
         border: bool = False,
+        width: Width = "stretch",
     ) -> DeltaGenerator:
         r"""Display a metric in big bold font, with an optional indicator of how the metric changed.
 
@@ -122,6 +124,11 @@ class MetricMixin:
             ``False`` (default), no border is shown. If this is ``True``, a
             border is shown.
 
+        width : int or "stretch" or "content"
+            The width of the metric. Can be either an integer (pixels), "stretch", or "content".
+            Defaults to "stretch". If "stretch", the metric will stretch to fill the available
+            space. If "content", the metric will adjust its width to fit its content.
+
         Examples
         --------
         **Example 1: Show a metric**
@@ -204,7 +211,10 @@ class MetricMixin:
             label_visibility
         )
 
-        return self.dg._enqueue("metric", metric_proto)
+        validate_width(width, allow_content=True)
+        layout_config = LayoutConfig(width=width)
+
+        return self.dg._enqueue("metric", metric_proto, layout_config=layout_config)
 
     @property
     def dg(self) -> DeltaGenerator:

streamlit/elements/plotly_chart.py

@@ -33,7 +33,6 @@ from typing_extensions import Required, TypeAlias
 
 from streamlit import type_util
 from streamlit.deprecation_util import show_deprecation_warning
-from streamlit.elements.lib.event_utils import AttributeDictionary
 from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.policies import check_widget_policies
 from streamlit.elements.lib.streamlit_plotly_theme import (
@@ -45,6 +44,7 @@ from streamlit.proto.PlotlyChart_pb2 import PlotlyChart as PlotlyChartProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner_utils.script_run_context import get_script_run_ctx
 from streamlit.runtime.state import WidgetCallback, register_widget
+from streamlit.util import AttributeDictionary
 
 if TYPE_CHECKING:
     from collections.abc import Iterable

streamlit/elements/text.py

@@ -16,12 +16,14 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, cast
 
+from streamlit.elements.lib.layout_utils import LayoutConfig, validate_width
 from streamlit.proto.Text_pb2 import Text as TextProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.string_util import clean_text
 
 if TYPE_CHECKING:
     from streamlit.delta_generator import DeltaGenerator
+    from streamlit.elements.lib.layout_utils import Width
     from streamlit.type_util import SupportsStr
 
 
@@ -32,6 +34,7 @@ class TextMixin:
         body: SupportsStr,
         *,  # keyword-only arguments:
         help: str | None = None,
+        width: Width = "content",
     ) -> DeltaGenerator:
         r"""Write text without Markdown or HTML parsing.
 
@@ -53,6 +56,11 @@ class TextMixin:
             including the Markdown directives described in the ``body``
             parameter of ``st.markdown``.
 
+        width : int or "stretch" or "content"
+            The width of the text element. Can be an integer (pixels), "stretch" to
+            use the full width of the container, or "content" (default) to size
+            based on the content.
+
         Example
         -------
         >>> import streamlit as st
@@ -68,7 +76,11 @@ class TextMixin:
         text_proto.body = clean_text(body)
         if help:
             text_proto.help = help
-        return self.dg._enqueue("text", text_proto)
+
+        validate_width(width, allow_content=True)
+        layout_config = LayoutConfig(width=width)
+
+        return self.dg._enqueue("text", text_proto, layout_config=layout_config)
 
     @property
     def dg(self) -> DeltaGenerator:

streamlit/elements/vega_charts.py

@@ -42,7 +42,6 @@ from streamlit.elements.lib.built_in_chart_utils import (
     generate_chart,
     maybe_raise_stack_warning,
 )
-from streamlit.elements.lib.event_utils import AttributeDictionary
 from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.policies import check_widget_policies
 from streamlit.elements.lib.utils import Key, compute_and_register_element_id, to_key
@@ -53,7 +52,7 @@ from streamlit.proto.ArrowVegaLiteChart_pb2 import (
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner_utils.script_run_context import get_script_run_ctx
 from streamlit.runtime.state import WidgetCallback, register_widget
-from streamlit.util import calc_md5
+from streamlit.util import AttributeDictionary, calc_md5
 
 if TYPE_CHECKING:
     from collections.abc import Iterable, Sequence
@@ -250,6 +249,30 @@ class VegaLiteStateSerde:
         return json.dumps(selection_state, default=str)
 
 
+def _patch_null_legend_titles(spec: VegaLiteSpec) -> None:
+    """Patches null legend titles in the 'color' channel of the spec.
+    This is a fix for the Vega-Lite bug where null legend titles
+    cause a wrong formatting of the chart as shown on the issue #9339.
+    """
+
+    encoding = spec.get("encoding")
+    if not isinstance(encoding, dict):
+        return
+
+    color_spec = encoding.get("color")
+    if not isinstance(color_spec, dict):
+        return
+
+    if "title" in color_spec and color_spec.get("title") is None:
+        # Patch legend title given null value directly in the encoding
+        color_spec["title"] = " "
+
+    legend = color_spec.get("legend")
+    if isinstance(legend, dict) and "title" in legend and legend.get("title") is None:
+        # Patch legend title given null value in the legend
+        legend["title"] = " "
+
+
 def _prepare_vega_lite_spec(
     spec: VegaLiteSpec,
     use_container_width: bool,
@@ -278,6 +301,8 @@ def _prepare_vega_lite_spec(
         else:
             spec["autosize"] = {"type": "fit", "contains": "padding"}
 
+    _patch_null_legend_titles(spec)
+
     return spec
 
 

streamlit/elements/widgets/checkbox.py

@@ -19,6 +19,11 @@ from textwrap import dedent
 from typing import TYPE_CHECKING, cast
 
 from streamlit.elements.lib.form_utils import current_form_id
+from streamlit.elements.lib.layout_utils import (
+    LayoutConfig,
+    Width,
+    validate_width,
+)
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,
@@ -69,6 +74,7 @@ class CheckboxMixin:
         *,  # keyword-only arguments:
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
+        width: Width = "content",
     ) -> bool:
         r"""Display a checkbox widget.
 
@@ -133,6 +139,10 @@ class CheckboxMixin:
             label, which can help keep the widget aligned with other widgets.
             If this is ``"collapsed"``, Streamlit displays no label or spacer.
 
+        width : Width
+            The width of the widget. Can be an integer for pixel width,
+            or one of "content" or "stretch". Defaults to "content".
+
         Returns
         -------
         bool
@@ -165,6 +175,7 @@ class CheckboxMixin:
             label_visibility=label_visibility,
             type=CheckboxProto.StyleType.DEFAULT,
             ctx=ctx,
+            width=width,
         )
 
     @gather_metrics("toggle")
@@ -180,6 +191,7 @@ class CheckboxMixin:
         *,  # keyword-only arguments:
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
+        width: Width = "content",
     ) -> bool:
         r"""Display a toggle widget.
 
@@ -244,6 +256,10 @@ class CheckboxMixin:
             label, which can help keep the widget aligned with other widgets.
             If this is ``"collapsed"``, Streamlit displays no label or spacer.
 
+        width : Width
+            The width of the widget. Can be an integer for pixel width,
+            or one of "content" or "stretch". Defaults to "content".
+
         Returns
         -------
         bool
@@ -276,6 +292,7 @@ class CheckboxMixin:
             label_visibility=label_visibility,
             type=CheckboxProto.StyleType.TOGGLE,
             ctx=ctx,
+            width=width,
         )
 
     def _checkbox(
@@ -292,6 +309,7 @@ class CheckboxMixin:
         label_visibility: LabelVisibility = "visible",
         type: CheckboxProto.StyleType.ValueType = CheckboxProto.StyleType.DEFAULT,
         ctx: ScriptRunContext | None = None,
+        width: Width = "content",
     ) -> bool:
         key = to_key(key)
 
@@ -311,6 +329,7 @@ class CheckboxMixin:
             label=label,
             value=bool(value),
             help=help,
+            width=width,
         )
 
         checkbox_proto = CheckboxProto()
@@ -327,6 +346,9 @@ class CheckboxMixin:
         if help is not None:
             checkbox_proto.help = dedent(help)
 
+        validate_width(width, allow_content=True)
+        layout_config = LayoutConfig(width=width)
+
         serde = CheckboxSerde(value)
 
         checkbox_state = register_widget(
@@ -344,7 +366,7 @@ class CheckboxMixin:
             checkbox_proto.value = checkbox_state.value
             checkbox_proto.set_value = True
 
-        self.dg._enqueue("checkbox", checkbox_proto)
+        self.dg._enqueue("checkbox", checkbox_proto, layout_config=layout_config)
         return checkbox_state.value
 
     @property