streamlit-nightly 1.43.3.dev20250317__py3-none-any.whl → 1.43.3.dev20250319__py3-none-any.whl

streamlit/auth_util.py

@@ -79,7 +79,7 @@ def get_secrets_auth_section() -> AttrDict:
     auth_section = AttrDict({})
     """Get the 'auth' section of the secrets.toml."""
     if secrets_singleton.load_if_toml_exists():
-        auth_section = cast(AttrDict, secrets_singleton.get("auth"))
+        auth_section = cast("AttrDict", secrets_singleton.get("auth"))
 
     return auth_section
 

streamlit/commands/page_config.py

@@ -262,7 +262,7 @@ def set_page_config(
     msg.page_config_changed.initial_sidebar_state = pb_sidebar_state
 
     if menu_items is not None:
-        lowercase_menu_items = cast(MenuItems, _lower_clean_dict_keys(menu_items))
+        lowercase_menu_items = cast("MenuItems", _lower_clean_dict_keys(menu_items))
         validate_menu_items(lowercase_menu_items)
         menu_items_proto = msg.page_config_changed.menu_items
         set_menu_items_proto(lowercase_menu_items, menu_items_proto)

streamlit/config.py

@@ -22,7 +22,7 @@ import secrets
 import threading
 from collections import OrderedDict
 from enum import Enum
-from typing import Any, Callable
+from typing import Any, Callable, Literal
 
 from blinker import Signal
 
@@ -86,6 +86,12 @@ class ShowErrorDetailsConfigOptions(str, Enum):
         # command-line and bool when set via user script (e.g. st.set_option("client.showErrorDetails", False)).
 
 
+class CustomThemeCategories(str, Enum):
+    """Theme categories that can be set with custom theme config."""
+
+    SIDEBAR = "sidebar"
+
+
 def set_option(key: str, value: Any, where_defined: str = _USER_DEFINED) -> None:
     """Set config option.
 
@@ -293,6 +299,36 @@ def _create_option(
     return option
 
 
+def _create_theme_options(
+    name: str,
+    categories: list[Literal["theme"] | CustomThemeCategories],
+    description: str | None = None,
+    default_val: Any | None = None,
+    visibility: str = "visible",
+    type_: type = str,
+) -> None:
+    """
+    Create ConfigOption(s) for a theme-related config option and store it globally in this module.
+    The same config option can be supported for multiple categories, e.g. "theme" and "theme.sidebar".
+    """
+    for cat in categories:
+        section = cat if cat == "theme" else f"theme.{cat.value}"
+
+        _create_option(
+            f"{section}.{name}",
+            description=description,
+            default_val=default_val,
+            visibility=visibility,
+            type_=type_,
+            scriptable=False,
+            deprecated=False,
+            deprecation_text=None,
+            expiration_date=None,
+            replaced_by=None,
+            sensitive=False,
+        )
+
+
 def _delete_option(key: str) -> None:
     """Remove a ConfigOption by key from the global store.
 
@@ -1004,42 +1040,61 @@ _create_option(
 
 _create_section("theme", "Settings to define a custom theme for your Streamlit app.")
 
-_create_option(
-    "theme.base",
+# Create a section for each custom theme element
+for cat in list(CustomThemeCategories):
+    _create_section(
+        f"theme.{cat.value}",
+        f"Settings to define a custom {cat.value} theme in your Streamlit app.",
+    )
+
+_create_theme_options(
+    "base",
+    categories=["theme"],
     description="""
         The preset Streamlit theme that your custom theme inherits from.
         One of "light" or "dark".
     """,
 )
 
-_create_option(
-    "theme.primaryColor",
+_create_theme_options(
+    "primaryColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="Primary accent color for interactive elements.",
 )
 
-_create_option(
-    "theme.backgroundColor",
+_create_theme_options(
+    "backgroundColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="Background color for the main content area.",
 )
 
-_create_option(
-    "theme.secondaryBackgroundColor",
+_create_theme_options(
+    "secondaryBackgroundColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="Background color used for the sidebar and most interactive widgets.",
 )
 
-_create_option(
-    "theme.textColor",
+_create_theme_options(
+    "textColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="Color used for almost all text.",
 )
 
-_create_option(
-    "theme.linkColor",
+_create_theme_options(
+    "linkColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="Color used for all links.",
-    visibility="hidden",
 )
 
-_create_option(
-    "theme.font",
+_create_theme_options(
+    "codeBackgroundColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
+    description="Background color used for code blocks.",
+)
+
+_create_theme_options(
+    "font",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
         The font family for all text in the app, except code blocks. One of "sans serif",
         "serif", or "monospace".
@@ -1047,78 +1102,77 @@ _create_option(
     """,
 )
 
-_create_option(
-    "theme.codeFont",
+_create_theme_options(
+    "codeFont",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
         The font family to use for code (monospace) in the app.
         To use a custom font, it needs to be added via [theme.fontFaces].
     """,
-    visibility="hidden",
 )
 
-_create_option(
-    "theme.headingFont",
+_create_theme_options(
+    "headingFont",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     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",
+_create_theme_options(
+    "fontFaces",
+    categories=["theme"],
     description="""
     Configure a list of font faces that you can use for the app & code fonts.
 """,
-    visibility="hidden",
 )
 
-
-_create_option(
-    "theme.baseRadius",
+_create_theme_options(
+    "baseRadius",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
         The radius used as basis for the corners of most UI elements. Can be:
         "none", "small", "medium", "large", "full", or the number in pixel or rem.
         For example: "10px", "0.5rem", "1.2rem", "2rem".
     """,
-    visibility="hidden",
 )
 
-_create_option(
-    "theme.borderColor",
+_create_theme_options(
+    "borderColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
         The color of the border around elements.
     """,
-    visibility="hidden",
 )
 
-_create_option(
-    "theme.showBorderAroundInputs",
+_create_theme_options(
+    "showWidgetBorder",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
-        Whether to show a border around input elements (e.g. text_input, number_input,
+        Whether to show a border around input widgets (e.g. text_input, number_input,
         file_uploader, etc).
     """,
     type_=bool,
-    visibility="hidden",
 )
 
-_create_option(
-    "theme.baseFontSize",
+_create_theme_options(
+    "baseFontSize",
+    categories=["theme"],
     description="""
         Sets the root font size (in pixels) for the app, which determines the overall
         scale of text and UI elements. The default base font size is 16.
     """,
     type_=int,
-    visibility="hidden",
 )
 
-_create_option(
-    "theme.showSidebarSeparator",
+_create_theme_options(
+    "showSidebarBorder",
+    categories=["theme"],
     description="""
         Whether to show a vertical separator between the sidebar and the main content.
     """,
     type_=bool,
-    visibility="hidden",
 )
 
 # Config Section: Secrets #
@@ -1275,10 +1329,52 @@ def _update_config_with_toml(raw_toml: str, where_defined: str) -> None:
 
     parsed_config_file = toml.loads(raw_toml)
 
+    def process_section(section_path: str, section_data: dict[str, Any]) -> None:
+        """Recursively process nested sections of the config file.
+
+        Parameters
+        ----------
+        section_path : str
+            The dot-separated path to the current section (e.g., "server" or "theme")
+        section_data : dict[str, Any]
+            The dictionary containing configuration values for this section
+
+        Notes
+        -----
+        TOML's hierarchical structure gets parsed into nested dictionaries.
+        For example:
+            [main]
+            option = "value"
+
+            [main.subsection]
+            another = "value2"
+
+        Will be loaded by the TOML parser as:
+            {
+                "main": {
+                    "option": "value",
+                    "subsection": {
+                        "another": "value2"
+                    }
+                }
+            }
+
+        This function traverses these nested dictionaries and converts them
+        to dot-notation config options.
+        """
+
+        for name, value in section_data.items():
+            option_name = f"{section_path}.{name}"
+            # Process it as a nested config section if it's a custom theme sub-category
+            if name in [CustomThemeCategories.SIDEBAR.value]:
+                process_section(option_name, value)
+            else:
+                # It's a regular config option, set it
+                value = _maybe_read_env_variable(value)
+                _set_option(option_name, value, where_defined)
+
     for section, options in parsed_config_file.items():
-        for name, value in options.items():
-            value = _maybe_read_env_variable(value)
-            _set_option(f"{section}.{name}", value, where_defined)
+        process_section(section, options)
 
 
 def _maybe_read_env_variable(value: Any) -> Any:

streamlit/config_option.py

@@ -152,8 +152,11 @@ class ConfigOption:
             # with a lowercase letter with an optional "_" preceding it.
             # Examples: "_section", "section1"
             r"\_?[a-z][a-zA-Z0-9]*"
+            # Handling zero or additional parts, separated by period
+            # Examples: "_section.subsection", "section1._section2"
+            r"(\.[a-z][a-zA-Z0-9]*)*"
             r")"
-            # Separator between groups
+            # The final period, separating section and name
             r"\."
             # Capture a group called "name"
             r"(?P<name>"

streamlit/config_util.py

@@ -88,7 +88,7 @@ def show_config(
         out.append("")
 
         for key, option in section_options.items():
-            key = option.key.split(".")[1]
+            key = option.key.split(".")[-1]
             description_paragraphs = _clean_paragraphs(option.description or "")
 
             last_paragraph_idx = len(description_paragraphs) - 1

streamlit/connections/snowflake_connection.py

@@ -264,7 +264,7 @@ class SnowflakeConnection(BaseConnection["InternalSnowflakeConnection"]):
 
             return snowflake.connector.connect(**kwargs)
         except SnowflakeError as e:
-            if not len(st_secrets) and not len(kwargs):
+            if not len(st_secrets) and not kwargs:
                 raise StreamlitAPIException(
                     "Missing Snowflake connection configuration. "
                     "Did you forget to set this in `secrets.toml`, a Snowflake configuration file, "
@@ -557,5 +557,5 @@ class SnowflakeConnection(BaseConnection["InternalSnowflakeConnection"]):
             return get_active_session()
 
         return cast(
-            Session, Session.builder.configs({"connection": self._instance}).create()
+            "Session", Session.builder.configs({"connection": self._instance}).create()
         )

streamlit/connections/snowpark_connection.py

@@ -91,7 +91,7 @@ class SnowparkConnection(BaseConnection["Session"]):
             if p not in conn_params:
                 raise StreamlitAPIException(f"Missing Snowpark connection param: {p}")
 
-        return cast(Session, Session.builder.configs(conn_params).create())
+        return cast("Session", Session.builder.configs(conn_params).create())
 
     def query(
         self,

streamlit/connections/sql_connection.py

@@ -390,7 +390,7 @@ class SQLConnection(BaseConnection["Engine"]):
         str
             The name of the driver. For example, ``"pyodbc"`` or ``"psycopg2"``.
         """
-        return cast(str, self._instance.driver)
+        return cast("str", self._instance.driver)
 
     @property
     def session(self) -> Session:

streamlit/connections/util.py

@@ -92,6 +92,6 @@ def running_in_sis() -> bool:
             is_in_stored_procedure,
         )
 
-        return cast(bool, is_in_stored_procedure())
+        return cast("bool", is_in_stored_procedure())
     except ModuleNotFoundError:
         return False

streamlit/dataframe_util.py

@@ -559,13 +559,13 @@ def convert_anything_to_pandas_df(
     import pandas as pd
 
     if isinstance(data, pd.DataFrame):
-        return data.copy() if ensure_copy else cast(pd.DataFrame, data)
+        return data.copy() if ensure_copy else cast("pd.DataFrame", data)
 
     if isinstance(data, (pd.Series, pd.Index, pd.api.extensions.ExtensionArray)):
         return pd.DataFrame(data)
 
     if is_pandas_styler(data):
-        return cast(pd.DataFrame, data.data.copy() if ensure_copy else data.data)
+        return cast("pd.DataFrame", data.data.copy() if ensure_copy else data.data)
 
     if isinstance(data, np.ndarray):
         return (
@@ -589,7 +589,7 @@ def convert_anything_to_pandas_df(
                 f"⚠️ Showing only {string_util.simplify_number(max_unevaluated_rows)} "
                 "rows. Call `collect()` on the dataframe to show more."
             )
-        return cast(pd.DataFrame, data)
+        return cast("pd.DataFrame", data)
 
     if is_xarray_dataset(data):
         if ensure_copy:
@@ -614,7 +614,7 @@ def convert_anything_to_pandas_df(
                 f"⚠️ Showing only {string_util.simplify_number(max_unevaluated_rows)} "
                 "rows. Call `compute()` on the data object to show more."
             )
-        return cast(pd.DataFrame, data)
+        return cast("pd.DataFrame", data)
 
     if is_ray_dataset(data):
         data = data.limit(max_unevaluated_rows).to_pandas()
@@ -624,7 +624,7 @@ def convert_anything_to_pandas_df(
                 f"⚠️ Showing only {string_util.simplify_number(max_unevaluated_rows)} "
                 "rows. Call `to_pandas()` on the dataset to show more."
             )
-        return cast(pd.DataFrame, data)
+        return cast("pd.DataFrame", data)
 
     if is_modin_data_object(data):
         data = data.head(max_unevaluated_rows)._to_pandas()
@@ -637,7 +637,7 @@ def convert_anything_to_pandas_df(
                 f"⚠️ Showing only {string_util.simplify_number(max_unevaluated_rows)} "
                 "rows. Call `_to_pandas()` on the data object to show more."
             )
-        return cast(pd.DataFrame, data)
+        return cast("pd.DataFrame", data)
 
     if is_pyspark_data_object(data):
         data = data.limit(max_unevaluated_rows).toPandas()
@@ -646,7 +646,7 @@ def convert_anything_to_pandas_df(
                 f"⚠️ Showing only {string_util.simplify_number(max_unevaluated_rows)} "
                 "rows. Call `toPandas()` on the data object to show more."
             )
-        return cast(pd.DataFrame, data)
+        return cast("pd.DataFrame", data)
 
     if is_snowpandas_data_object(data):
         data = data[:max_unevaluated_rows].to_pandas()
@@ -659,7 +659,7 @@ def convert_anything_to_pandas_df(
                 f"⚠️ Showing only {string_util.simplify_number(max_unevaluated_rows)} "
                 "rows. Call `to_pandas()` on the data object to show more."
             )
-        return cast(pd.DataFrame, data)
+        return cast("pd.DataFrame", data)
 
     if is_snowpark_data_object(data):
         data = data.limit(max_unevaluated_rows).to_pandas()
@@ -668,7 +668,7 @@ def convert_anything_to_pandas_df(
                 f"⚠️ Showing only {string_util.simplify_number(max_unevaluated_rows)} "
                 "rows. Call `to_pandas()` on the data object to show more."
             )
-        return cast(pd.DataFrame, data)
+        return cast("pd.DataFrame", data)
 
     if is_duckdb_relation(data):
         data = data.limit(max_unevaluated_rows).df()
@@ -800,7 +800,7 @@ def convert_arrow_table_to_arrow_bytes(table: pa.Table) -> bytes:
     writer = pa.RecordBatchStreamWriter(sink, table.schema)
     writer.write_table(table)
     writer.close()
-    return cast(bytes, sink.getvalue().to_pybytes())
+    return cast("bytes", sink.getvalue().to_pybytes())
 
 
 def convert_pandas_df_to_arrow_bytes(df: DataFrame) -> bytes:
@@ -951,7 +951,7 @@ def convert_anything_to_list(obj: OptionSequence[V_co]) -> list[V_co]:
         return (
             []
             if data_df.empty
-            else cast(list[V_co], list(data_df.iloc[:, 0].to_list()))
+            else cast("list[V_co]", list(data_df.iloc[:, 0].to_list()))
         )
     except errors.StreamlitAPIException:
         # Wrap the object into a list
@@ -1167,7 +1167,7 @@ def determine_data_format(input_data: Any) -> DataFormat:
     elif isinstance(input_data, pd.DataFrame):
         return DataFormat.PANDAS_DATAFRAME
     elif isinstance(input_data, np.ndarray):
-        if len(cast(NumpyShape, input_data.shape)) == 1:
+        if len(cast("NumpyShape", input_data.shape)) == 1:
             # For technical reasons, we need to distinguish one
             # one-dimensional numpy array from multidimensional ones.
             return DataFormat.NUMPY_LIST

streamlit/delta_generator.py

@@ -538,7 +538,7 @@ class DeltaGenerator(
             dg_type = DeltaGenerator
 
         block_dg = cast(
-            DeltaGenerator,
+            "DeltaGenerator",
             dg_type(
                 root_container=dg._root_container,
                 cursor=block_cursor,
@@ -566,7 +566,7 @@ class DeltaGenerator(
 
 def _writes_directly_to_sidebar(dg: DeltaGenerator) -> bool:
     in_sidebar = any(a._root_container == RootContainer.SIDEBAR for a in dg._ancestors)
-    has_container = bool(len(list(dg._ancestor_block_types)))
+    has_container = bool(list(dg._ancestor_block_types))
     return in_sidebar and not has_container
 
 

streamlit/deprecation_util.py

@@ -105,7 +105,7 @@ def deprecate_func_name(
     # Update the wrapped func's name & docstring so st.help does the right thing
     wrapped_func.__name__ = old_name
     wrapped_func.__doc__ = func.__doc__
-    return cast(TFunc, wrapped_func)
+    return cast("TFunc", wrapped_func)
 
 
 def deprecate_obj_name(
@@ -206,4 +206,4 @@ def _create_deprecated_obj_wrapper(obj: TObj, show_warning: Callable[[], Any]) -
 
             return proxy
 
-    return cast(TObj, Wrapper())
+    return cast("TObj", Wrapper())

streamlit/elements/arrow.py

@@ -174,7 +174,7 @@ class DataframeSelectionSerde:
         if "selection" not in selection_state:
             selection_state = empty_selection_state
 
-        return cast(DataframeState, AttributeDictionary(selection_state))
+        return cast("DataframeState", AttributeDictionary(selection_state))
 
     def serialize(self, editing_state: DataframeState) -> str:
         return json.dumps(editing_state, default=str)
@@ -549,7 +549,7 @@ class ArrowMixin:
             check_widget_policies(
                 self.dg,
                 key,
-                on_change=cast(WidgetCallback, on_select) if is_callback else None,
+                on_change=cast("WidgetCallback", on_select) if is_callback else None,
                 default_value=None,
                 writes_allowed=False,
                 enable_check_callback_rules=is_callback,
@@ -644,7 +644,7 @@ class ArrowMixin:
                 value_type="string_value",
             )
             self.dg._enqueue("arrow_data_frame", proto)
-            return cast(DataframeState, widget_state.value)
+            return cast("DataframeState", widget_state.value)
         else:
             return self.dg._enqueue("arrow_data_frame", proto)
 

streamlit/elements/deck_gl_json_chart.py

@@ -251,7 +251,7 @@ class PydeckSelectionSerde:
         if "selection" not in selection_state:
             selection_state = empty_selection_state
 
-        return cast(PydeckState, AttributeDictionary(selection_state))
+        return cast("PydeckState", AttributeDictionary(selection_state))
 
     def serialize(self, selection_state: PydeckState) -> str:
         return json.dumps(selection_state, default=str)
@@ -488,7 +488,7 @@ class PydeckMixin:
             check_widget_policies(
                 self.dg,
                 key,
-                on_change=cast(WidgetCallback, on_select) if is_callback else None,
+                on_change=cast("WidgetCallback", on_select) if is_callback else None,
                 default_value=None,
                 writes_allowed=False,
                 enable_check_callback_rules=is_callback,
@@ -518,7 +518,7 @@ class PydeckMixin:
 
             self.dg._enqueue("deck_gl_json_chart", pydeck_proto)
 
-            return cast(PydeckState, widget_state.value)
+            return cast("PydeckState", widget_state.value)
 
         return self.dg._enqueue("deck_gl_json_chart", pydeck_proto)
 
@@ -541,6 +541,6 @@ def _get_pydeck_tooltip(pydeck_obj: Deck | None) -> dict[str, str] | None:
     # For details, see: https://github.com/visgl/deck.gl/pull/7125/files
     tooltip = getattr(pydeck_obj, "_tooltip", None)
     if tooltip is not None and isinstance(tooltip, dict):
-        return cast(dict[str, str], tooltip)
+        return cast("dict[str, str]", tooltip)
 
     return None

streamlit/elements/dialog_decorator.py

@@ -102,7 +102,7 @@ def _dialog_decorator(
         # the fragment decorator has multiple return types so that you can pass
         # arguments to it. Here we know the return type, so we cast
         fragmented_dialog_content = cast(
-            Callable[[], None],
+            "Callable[[], None]",
             _fragment(
                 dialog_content, additional_hash_info=non_optional_func.__qualname__
             ),
@@ -112,7 +112,7 @@ def _dialog_decorator(
             fragmented_dialog_content()
             return None
 
-    return cast(F, wrap)
+    return cast("F", wrap)
 
 
 @overload

streamlit/elements/heading.py

@@ -261,7 +261,7 @@ class HeadingMixin:
             "rainbow",
         ]
         if divider in valid_colors:
-            return cast(str, divider)
+            return cast("str", divider)
         else:
             raise StreamlitAPIException(
                 f"Divider parameter has invalid value: `{divider}`. Please choose from: {', '.join(valid_colors)}."

streamlit/elements/html.py

@@ -75,16 +75,16 @@ class HtmlMixin:
 
         # If body supports _repr_html_, use that.
         if has_callable_attr(body, "_repr_html_"):
-            html_proto.body = cast(SupportsReprHtml, body)._repr_html_()
+            html_proto.body = cast("SupportsReprHtml", body)._repr_html_()
 
         # Check if the body is a file path. May include filesystem lookup.
         elif isinstance(body, Path) or _is_file(body):
-            with open(cast(str, body), encoding="utf-8") as f:
+            with open(cast("str", body), encoding="utf-8") as f:
                 html_proto.body = f.read()
 
         # OK, let's just try converting to string and hope for the best.
         else:
-            html_proto.body = clean_text(cast(SupportsStr, body))
+            html_proto.body = clean_text(cast("SupportsStr", body))
 
         return self.dg._enqueue("html", html_proto)