streamlit-nightly 1.45.1.dev20250505__py3-none-any.whl → 1.45.1.dev20250507__py3-none-any.whl

streamlit/__init__.py

@@ -286,7 +286,10 @@ experimental_dialog = _experimental_dialog_decorator
 experimental_fragment = _experimental_fragment
 experimental_user = _DeprecatedUserInfoProxy()
 
-_EXPERIMENTAL_QUERY_PARAMS_DEPRECATE_MSG = "Refer to our [docs page](https://docs.streamlit.io/develop/api-reference/caching-and-state/st.query_params) for more information."
+_EXPERIMENTAL_QUERY_PARAMS_DEPRECATE_MSG = (
+    "Refer to our [docs page](https://docs.streamlit.io/develop/api-reference/caching-and-state/st.query_params) "
+    "for more information."
+)
 
 experimental_get_query_params = _deprecate_func_name(
     _get_query_params,

streamlit/column_config.py

@@ -12,7 +12,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-"""Column types that can be configured via the ``column_config`` parameter of ``st.dataframe`` and ``st.data_editor``."""
+"""Column types that can be configured via the ``column_config`` parameter of
+``st.dataframe`` and ``st.data_editor``.
+"""
 
 from __future__ import annotations
 

streamlit/commands/execution_control.py

@@ -219,7 +219,9 @@ def switch_page(page: str | Path | StreamlitPage) -> NoReturn:  # type: ignore[m
 
         if len(matched_pages) == 0:
             raise StreamlitAPIException(
-                f"Could not find page: `{page}`. Must be the file path relative to the main script, from the directory: `{os.path.basename(main_script_directory)}`. Only the main app file and files in the `pages/` directory are supported."
+                f"Could not find page: `{page}`. Must be the file path relative to the main script, "
+                f"from the directory: `{os.path.basename(main_script_directory)}`. Only the main app file "
+                "and files in the `pages/` directory are supported."
             )
 
         page_script_hash = matched_pages[0]["page_script_hash"]

streamlit/commands/logo.py

@@ -27,7 +27,11 @@ from streamlit.runtime.scriptrunner_utils.script_run_context import get_script_r
 
 
 def _invalid_logo_text(field_name: str):
-    return f"The {field_name} passed to st.logo is invalid - See [documentation](https://docs.streamlit.io/develop/api-reference/media/st.logo) for more information on valid types"
+    return (
+        f"The {field_name} passed to st.logo is invalid - See "
+        "[documentation](https://docs.streamlit.io/develop/api-reference/media/st.logo) "
+        "for more information on valid types"
+    )
 
 
 @gather_metrics("logo")
@@ -154,7 +158,8 @@ def logo(
             fwd_msg.logo.link = link
         else:
             raise StreamlitAPIException(
-                f"Invalid link: {link} - the link param supports external links only and must start with either http:// or https://."
+                f"Invalid link: {link} - the link param supports external links only and must "
+                f"start with either http:// or https://."
             )
 
     if icon_image:

streamlit/connections/base_connection.py

@@ -78,12 +78,12 @@ class BaseConnection(ABC, Generic[RawConnectionT]):
     def __getattribute__(self, name: str) -> Any:
         try:
             return object.__getattribute__(self, name)
-        except AttributeError as e:
+        except AttributeError:
             if hasattr(self._instance, name):
                 raise AttributeError(
                     f"`{name}` doesn't exist here, but you can call `._instance.{name}` instead"
                 )
-            raise e
+            raise
 
     # Methods with default implementations that we don't expect subclasses to want or
     # need to overwrite.

streamlit/connections/snowflake_connection.py

@@ -263,16 +263,17 @@ class SnowflakeConnection(BaseConnection["InternalSnowflakeConnection"]):
                 return snowflake.connector.connect()
 
             return snowflake.connector.connect(**kwargs)
-        except SnowflakeError as e:
+        except SnowflakeError:
             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, "
                     "or as kwargs to `st.connection`? "
-                    "See the [SnowflakeConnection configuration documentation](https://docs.streamlit.io/st.connections.snowflakeconnection-configuration) "
+                    "See the [SnowflakeConnection configuration documentation]"
+                    "(https://docs.streamlit.io/st.connections.snowflakeconnection-configuration) "
                     "for more details and examples."
                 )
-            raise e
+            raise
 
     def query(
         self,

streamlit/dataframe_util.py

@@ -1319,7 +1319,8 @@ def convert_pandas_df_to_data_format(
 
     Returns
     -------
-    pd.DataFrame, pd.Series, pyarrow.Table, np.ndarray, xarray.Dataset, xarray.DataArray, polars.Dataframe, polars.Series, list, set, tuple, or dict.
+    pd.DataFrame, pd.Series, pyarrow.Table, np.ndarray, xarray.Dataset,
+    xarray.DataArray, polars.Dataframe, polars.Series, list, set, tuple, or dict.
         The converted dataframe.
     """
 

streamlit/delta_generator.py

@@ -147,6 +147,19 @@ def _maybe_print_use_warning() -> None:
             )
 
 
+def _maybe_print_fragment_callback_warning() -> None:
+    """Print a warning if elements are being modified during a fragment callback."""
+    ctx = get_script_run_ctx()
+    if ctx and getattr(ctx, "in_fragment_callback", False):
+        warning = cli_util.style_for_cli("Warning:", bold=True, fg="yellow")
+
+        logger.get_logger("root").warning(
+            f"\n  {warning} A fragment rerun was triggered with a callback that displays one or more elements. "
+            "During a fragment rerun, within a callback, displaying elements is not officially supported because "
+            "those elements will replace the existing elements at the top of your app."
+        )
+
+
 class DeltaGenerator(
     AlertMixin,
     AudioInputMixin,
@@ -454,6 +467,8 @@ class DeltaGenerator(
 
         # Warn if an element is being changed but the user isn't running the streamlit server.
         _maybe_print_use_warning()
+        # Warn if an element is being changed during a fragment callback.
+        _maybe_print_fragment_callback_warning()
 
         # Copy the marshalled proto into the overall msg proto
         msg = ForwardMsg_pb2.ForwardMsg()
@@ -514,9 +529,6 @@ class DeltaGenerator(
 
         # Prevent nested columns & expanders by checking all parents.
         block_type = block_proto.WhichOneof("type")
-        # Convert the generator to a list, so we can use it multiple times.
-        ancestor_block_types = list(dg._ancestor_block_types)
-        _check_nested_element_violation(self, block_type, ancestor_block_types)
 
         if dg._root_container is None or dg._cursor is None:
             return dg
@@ -569,35 +581,3 @@ def _writes_directly_to_sidebar(dg: DeltaGenerator) -> bool:
     in_sidebar = any(a._root_container == RootContainer.SIDEBAR for a in dg._ancestors)
     has_container = bool(list(dg._ancestor_block_types))
     return in_sidebar and not has_container
-
-
-def _check_nested_element_violation(
-    dg: DeltaGenerator, block_type: str | None, ancestor_block_types: list[BlockType]
-) -> None:
-    """Check if elements are nested in a forbidden way.
-
-    Raises
-    ------
-      StreamlitAPIException: throw if an invalid element nesting is detected.
-    """
-
-    if block_type == "column":
-        num_of_parent_columns = dg._count_num_of_parent_columns(ancestor_block_types)
-        if dg._root_container == RootContainer.SIDEBAR and num_of_parent_columns > 0:
-            raise StreamlitAPIException(
-                "Columns cannot be placed inside other columns in the sidebar. This is only possible in the main area of the app."
-            )
-        if num_of_parent_columns > 1:
-            raise StreamlitAPIException(
-                "Columns can only be placed inside other columns up to one level of nesting."
-            )
-    if block_type == "chat_message" and block_type in ancestor_block_types:
-        raise StreamlitAPIException(
-            "Chat messages cannot nested inside other chat messages."
-        )
-    if block_type == "expandable" and block_type in ancestor_block_types:
-        raise StreamlitAPIException(
-            "Expanders may not be nested inside other expanders."
-        )
-    if block_type == "popover" and block_type in ancestor_block_types:
-        raise StreamlitAPIException("Popovers may not be nested inside other popovers.")

streamlit/elements/arrow.py

@@ -370,7 +370,7 @@ class ArrowMixin:
 
             - A column type within ``st.column_config``: Streamlit applies the
               defined configuration to the column. For example, use
-              ``st.column_config.NumberColumn("Dollar values”, format=”$ %d")``
+              ``st.column_config.NumberColumn("Dollar values", format="$ %d")``
               to change the displayed name of the column to "Dollar values"
               and add a "$" prefix in each cell. For more info on the
               available column types and config options, see
@@ -789,7 +789,7 @@ class ArrowMixin:
         ... )
         >>> my_chart.add_rows(some_fancy_name=df2)  # <-- name used as keyword
 
-        """
+        """  # noqa: E501
         return _arrow_add_rows(self.dg, data, **kwargs)
 
     @property
@@ -948,7 +948,7 @@ def marshall(proto: ArrowProto, data: Data, default_uuid: str | None = None) ->
         This attribute is optional and only used for pandas.Styler, other elements
         (e.g. charts) can ignore it.
 
-    """
+    """  # noqa: E501
 
     if dataframe_util.is_pandas_styler(data):
         # default_uuid is a string only if the data is a `Styler`,

streamlit/elements/deck_gl_json_chart.py

@@ -268,7 +268,7 @@ class PydeckMixin:
         height: int | None = None,
         selection_mode: Literal[
             "single-object"
-        ],  # Selection mode will only be activated by on_select param, this is a default value here to make it work with mypy
+        ],  # Selection mode will only be activated by on_select param; default value here to make it work with mypy
         on_select: Literal["ignore"],  # No default value here to make it work with mypy
         key: Key | None = None,
     ) -> DeltaGenerator: ...

streamlit/elements/exception.py

@@ -38,7 +38,11 @@ _LOGGER: Final = get_logger(__name__)
 
 # When client.showErrorDetails is False, we show a generic warning in the
 # frontend when we encounter an uncaught app exception.
-_GENERIC_UNCAUGHT_EXCEPTION_TEXT: Final = "This app has encountered an error. The original error message is redacted to prevent data leaks.  Full error details have been recorded in the logs (if you're on Streamlit Cloud, click on 'Manage app' in the lower right of your app)."
+_GENERIC_UNCAUGHT_EXCEPTION_TEXT: Final = (
+    "This app has encountered an error. The original error message is redacted "
+    "to prevent data leaks. Full error details have been recorded in the logs "
+    "(if you're on Streamlit Cloud, click on 'Manage app' in the lower right of your app)."
+)
 
 
 class ExceptionMixin:

streamlit/elements/layouts.py

@@ -191,11 +191,8 @@ class LayoutsMixin:
         (preferred) or just call methods directly on the returned object. See
         examples below.
 
-        Columns can only be placed inside other columns up to one level of nesting.
-
-        .. warning::
-            Columns cannot be placed inside other columns in the sidebar. This
-            is only possible in the main area of the app.
+        .. note::
+            We recommend against nesting columns more than once since it might look bad on smaller devices.
 
         Parameters
         ----------
@@ -503,9 +500,6 @@ class LayoutsMixin:
         (preferred) or just call methods directly on the returned object. See
         examples below.
 
-        .. warning::
-            Currently, you may not put expanders inside another expander.
-
         Parameters
         ----------
         label : str
@@ -624,7 +618,7 @@ class LayoutsMixin:
         See examples below.
 
         .. warning::
-            You may not put a popover inside another popover.
+            We strongly advise against nesting popovers.
 
         Parameters
         ----------

streamlit/elements/lib/column_types.py

@@ -485,7 +485,7 @@ def NumberColumn(
     .. output::
         https://doc-number-column.streamlit.app/
         height: 300px
-    """
+    """  # noqa: E501
 
     return ColumnConfig(
         label=label,
@@ -2058,7 +2058,7 @@ def ProgressColumn(
     .. output::
         https://doc-progress-column.streamlit.app/
         height: 300px
-    """
+    """  # noqa: E501
 
     return ColumnConfig(
         label=label,

streamlit/elements/lib/dialog.py

@@ -67,7 +67,8 @@ def _assert_first_dialog_to_be_opened(should_open: bool) -> None:
     if should_open and script_run_ctx:
         if script_run_ctx.has_dialog_opened:
             raise StreamlitAPIException(
-                "Only one dialog is allowed to be opened at the same time. Please make sure to not call a dialog-decorated function more than once in a script run."
+                "Only one dialog is allowed to be opened at the same time. "
+                "Please make sure to not call a dialog-decorated function more than once in a script run."
             )
         script_run_ctx.has_dialog_opened = True
 

streamlit/elements/lib/js_number.py

@@ -17,7 +17,7 @@ from __future__ import annotations
 import numbers
 
 
-class JSNumberBoundsException(Exception):
+class JSNumberBoundsException(Exception):  # noqa: N818
     pass
 
 
@@ -67,7 +67,7 @@ class JSNumber:
             raise JSNumberBoundsException(
                 f"{value_name} ({value}) must be >= -((1 << 53) - 1)"
             )
-        elif value > cls.MAX_SAFE_INTEGER:
+        if value > cls.MAX_SAFE_INTEGER:
             raise JSNumberBoundsException(
                 f"{value_name} ({value}) must be <= (1 << 53) - 1"
             )
@@ -95,11 +95,11 @@ class JSNumber:
 
         if not isinstance(value, (numbers.Integral, float)):
             raise JSNumberBoundsException(f"{value_name} ({value}) is not a float")
-        elif value < cls.MIN_NEGATIVE_VALUE:
+        if value < cls.MIN_NEGATIVE_VALUE:
             raise JSNumberBoundsException(
                 f"{value_name} ({value}) must be >= -1.797e+308"
             )
-        elif value > cls.MAX_VALUE:
+        if value > cls.MAX_VALUE:
             raise JSNumberBoundsException(
                 f"{value_name} ({value}) must be <= 1.797e+308"
             )

streamlit/elements/lib/options_selector_utils.py

@@ -54,9 +54,12 @@ def index_(iterable: Iterable[_Value], x: _Value) -> int:
     for i, value in enumerate(iterable):
         if x == value:
             return i
-        elif isinstance(value, float) and isinstance(x, float):
-            if abs(x - value) < _FLOAT_EQUALITY_EPSILON:
-                return i
+        if (
+            isinstance(value, float)
+            and isinstance(x, float)
+            and abs(x - value) < _FLOAT_EQUALITY_EPSILON
+        ):
+            return i
     raise ValueError(f"{x} is not in iterable")
 
 
@@ -107,11 +110,11 @@ def _coerce_enum(from_enum_value: E1, to_enum_class: type[E2]) -> E1 | E2:
     match as well. (This is configurable in streamlist configs)
     """
     if not isinstance(from_enum_value, Enum):
-        raise ValueError(
+        raise ValueError(  # noqa: TRY004
             f"Expected an Enum in the first argument. Got {type(from_enum_value)}"
         )
     if not isinstance(to_enum_class, EnumMeta):
-        raise ValueError(
+        raise ValueError(  # noqa: TRY004
             f"Expected an EnumMeta/Type in the second argument. Got {type(to_enum_class)}"
         )
     if isinstance(from_enum_value, to_enum_class):

streamlit/elements/media.py

@@ -350,8 +350,9 @@ class MediaMixin:
         `video subtitles feature demo <https://doc-video-subtitle-inputs.streamlit.app/>`_.
 
         .. note::
-           Some videos may not display if they are encoded using MP4V (which is an export option in OpenCV), as this codec is
-           not widely supported by browsers. Converting your video to H.264 will allow the video to be displayed in Streamlit.
+           Some videos may not display if they are encoded using MP4V (which is an export option in OpenCV),
+           as this codec is not widely supported by browsers. Converting your video to H.264 will allow
+           the video to be displayed in Streamlit.
            See this `StackOverflow post <https://stackoverflow.com/a/49535220/2394542>`_ or this
            `Streamlit forum post <https://discuss.streamlit.io/t/st-video-doesnt-show-opencv-generated-mp4/3193/2>`_
            for more information.
@@ -453,8 +454,7 @@ def _marshall_av_media(
         read_data = data.read()
         if read_data is None:
             return
-        else:
-            data_or_filename = read_data
+        data_or_filename = read_data
     elif type_util.is_type(data, "numpy.ndarray"):
         data_or_filename = data.tobytes()
     else:
@@ -505,8 +505,9 @@ def marshall_video(
     subtitles: str, dict, or io.BytesIO
         Optional subtitle data for the video, supporting several input types:
         - None (default): No subtitles.
-        - A string: File path to a subtitle file in '.vtt' or '.srt' formats, or the raw content of subtitles conforming to these formats.
-            If providing raw content, the string must adhere to the WebVTT or SRT format specifications.
+        - A string: File path to a subtitle file in '.vtt' or '.srt' formats, or the raw content
+            of subtitles conforming to these formats. If providing raw content, the string must
+            adhere to the WebVTT or SRT format specifications.
         - A dictionary: Pairs of labels and file paths or raw subtitle content in '.vtt' or '.srt' formats.
             Enables multiple subtitle tracks. The label will be shown in the video player.
             Example: {'English': 'path/to/english.vtt', 'French': 'path/to/french.srt'}
@@ -621,7 +622,7 @@ def _parse_start_time_end_time(
     try:
         maybe_start_time = time_to_seconds(start_time, coerce_none_to_inf=False)
         if maybe_start_time is None:
-            raise ValueError
+            raise ValueError  # noqa: TRY301
         start_time = int(maybe_start_time)
     except (StreamlitAPIException, ValueError):
         error_msg = TIMEDELTA_PARSE_ERROR_MESSAGE.format(

streamlit/elements/vega_charts.py

@@ -442,8 +442,8 @@ def _parse_selection_mode(
         raise StreamlitAPIException(
             "Selections are activated, but the provided chart spec does not "
             "have any selections defined. To add selections to `st.altair_chart`, check out the documentation "
-            "[here](https://altair-viz.github.io/user_guide/interactions.html#selections-capturing-chart-interactions). "
-            "For adding selections to `st.vega_lite_chart`, take a look "
+            "[here](https://altair-viz.github.io/user_guide/interactions.html#selections-capturing-chart-interactions)."
+            " For adding selections to `st.vega_lite_chart`, take a look "
             "at the specification [here](https://vega.github.io/vega-lite/docs/selection.html)."
         )
 

streamlit/elements/widgets/button.py

@@ -940,10 +940,9 @@ class ButtonMixin:
             if is_url(page):
                 if label is None or label == "":
                     raise StreamlitMissingPageLabelError()
-                else:
-                    page_link_proto.page = page
-                    page_link_proto.external = True
-                    return self.dg._enqueue("page_link", page_link_proto)
+                page_link_proto.page = page
+                page_link_proto.external = True
+                return self.dg._enqueue("page_link", page_link_proto)
 
             ctx_main_script = ""
             all_app_pages = {}
@@ -1028,7 +1027,7 @@ class ButtonMixin:
                 raise StreamlitAPIException(
                     f"`st.button()` can't be used in an `st.form()`.{FORM_DOCS_INFO}"
                 )
-            elif not is_in_form(self.dg) and is_form_submitter:
+            if not is_in_form(self.dg) and is_form_submitter:
                 raise StreamlitAPIException(
                     f"`st.form_submit_button()` must be used inside an `st.form()`.{FORM_DOCS_INFO}"
                 )
@@ -1106,7 +1105,7 @@ def marshall_file(
         data_as_bytes = data.read() or b""
         mimetype = mimetype or "application/octet-stream"
     else:
-        raise RuntimeError("Invalid binary data format: %s" % type(data))
+        raise StreamlitAPIException("Invalid binary data format: %s" % type(data))
 
     if runtime.exists():
         file_url = runtime.get_instance().media_file_mgr.add(

streamlit/elements/widgets/number_input.py

@@ -82,10 +82,6 @@ class NumberInputSerde:
 
 
 class NumberInputMixin:
-    # For easier readability, all the arguments with un-changing types across these overload signatures have been
-    # collapsed onto a single line.
-
-    # fmt: off
     # If "min_value: int" is given and all other numerical inputs are
     #   "int"s or not provided (value optionally being "min"), return "int"
     # If "min_value: int, value: None" is given and all other numerical inputs
@@ -98,9 +94,19 @@ class NumberInputMixin:
         max_value: int | None = None,
         value: IntOrNone | Literal["min"] = "min",
         step: int | None = None,
-        format: str | None = None, key: Key | None = None, help: str | None = None, on_change: WidgetCallback | None = None, args: WidgetArgs | None = None, kwargs: WidgetKwargs | None = None, *, placeholder: str | None = None, disabled: bool = False, label_visibility: LabelVisibility = "visible", icon: str | None = None, width: WidthWithoutContent = "stretch"
-    ) -> int | IntOrNone:
-        ...
+        format: str | None = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        *,
+        placeholder: str | None = None,
+        disabled: bool = False,
+        label_visibility: LabelVisibility = "visible",
+        icon: str | None = None,
+        width: WidthWithoutContent = "stretch",
+    ) -> int | IntOrNone: ...
 
     # If "max_value: int" is given and all other numerical inputs are
     #   "int"s or not provided (value optionally being "min"), return "int"
@@ -115,9 +121,18 @@ class NumberInputMixin:
         max_value: int,
         value: IntOrNone | Literal["min"] = "min",
         step: int | None = None,
-        format: str | None = None, key: Key | None = None, help: str | None = None, on_change: WidgetCallback | None = None, args: WidgetArgs | None = None, kwargs: WidgetKwargs | None = None, placeholder: str | None = None, disabled: bool = False, label_visibility: LabelVisibility = "visible", icon: str | None = None, width: WidthWithoutContent = "stretch"
-    ) -> int | IntOrNone:
-        ...
+        format: str | None = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        placeholder: str | None = None,
+        disabled: bool = False,
+        label_visibility: LabelVisibility = "visible",
+        icon: str | None = None,
+        width: WidthWithoutContent = "stretch",
+    ) -> int | IntOrNone: ...
 
     # If "value=int" is given and all other numerical inputs are "int"s
     #   or not provided, return "int"
@@ -130,9 +145,18 @@ class NumberInputMixin:
         *,
         value: int,
         step: int | None = None,
-        format: str | None = None, key: Key | None = None, help: str | None = None, on_change: WidgetCallback | None = None, args: WidgetArgs | None = None, kwargs: WidgetKwargs | None = None, placeholder: str | None = None, disabled: bool = False, label_visibility: LabelVisibility = "visible", icon: str | None = None, width: WidthWithoutContent = "stretch"
-    ) -> int:
-        ...
+        format: str | None = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        placeholder: str | None = None,
+        disabled: bool = False,
+        label_visibility: LabelVisibility = "visible",
+        icon: str | None = None,
+        width: WidthWithoutContent = "stretch",
+    ) -> int: ...
 
     # If "step=int" is given and all other numerical inputs are "int"s
     #   or not provided (value optionally being "min"), return "int"
@@ -147,9 +171,18 @@ class NumberInputMixin:
         value: IntOrNone | Literal["min"] = "min",
         *,
         step: int,
-        format: str | None = None, key: Key | None = None, help: str | None = None, on_change: WidgetCallback | None = None, args: WidgetArgs | None = None, kwargs: WidgetKwargs | None = None, placeholder: str | None = None, disabled: bool = False, label_visibility: LabelVisibility = "visible", icon: str | None = None, width: WidthWithoutContent = "stretch"
-    ) -> int | IntOrNone:
-        ...
+        format: str | None = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        placeholder: str | None = None,
+        disabled: bool = False,
+        label_visibility: LabelVisibility = "visible",
+        icon: str | None = None,
+        width: WidthWithoutContent = "stretch",
+    ) -> int | IntOrNone: ...
 
     # If all numerical inputs are floats (with value optionally being "min")
     #   or are not provided, return "float"
@@ -163,10 +196,19 @@ class NumberInputMixin:
         max_value: float | None = None,
         value: FloatOrNone | Literal["min"] = "min",
         step: float | None = None,
-        format: str | None = None, key: Key | None = None, help: str | None = None, on_change: WidgetCallback | None = None, args: WidgetArgs | None = None, kwargs: WidgetKwargs | None = None, *, placeholder: str | None = None, disabled: bool = False, label_visibility: LabelVisibility = "visible", icon: str | None = None, width: WidthWithoutContent = "stretch"
-    ) -> float | FloatOrNone:
-        ...
-    # # fmt: on
+        format: str | None = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        *,
+        placeholder: str | None = None,
+        disabled: bool = False,
+        label_visibility: LabelVisibility = "visible",
+        icon: str | None = None,
+        width: WidthWithoutContent = "stretch",
+    ) -> float | FloatOrNone: ...
 
     @gather_metrics("number_input")
     def number_input(
@@ -426,7 +468,9 @@ class NumberInputMixin:
         )
 
         if not all_int_args and not all_float_args:
-            raise StreamlitMixedNumericTypesError(value=value, min_value=min_value, max_value=max_value, step=step)
+            raise StreamlitMixedNumericTypesError(
+                value=value, min_value=min_value, max_value=max_value, step=step
+            )
 
         session_state = get_session_state().filtered_state
         if key is not None and key in session_state and session_state[key] is None:
@@ -480,7 +524,6 @@ class NumberInputMixin:
         except (TypeError, ValueError):
             raise StreamlitInvalidNumberFormatError(number_format)
 
-
         # Ensure that the value matches arguments' types.
         all_ints = int_value and all_int_args
 
@@ -579,17 +622,27 @@ class NumberInputMixin:
             deserializer=serde.deserialize,
             serializer=serde.serialize,
             ctx=ctx,
-            value_type="double_value"
+            value_type="double_value",
         )
 
         if widget_state.value_changed:
             if widget_state.value is not None:
                 # Min/Max bounds checks when the value is updated.
-                if number_input_proto.has_min and widget_state.value < number_input_proto.min:
-                    raise StreamlitValueBelowMinError(value=widget_state.value, min_value=number_input_proto.min)
-
-                if number_input_proto.has_max and widget_state.value > number_input_proto.max:
-                    raise StreamlitValueAboveMaxError(value=widget_state.value, max_value=number_input_proto.max)
+                if (
+                    number_input_proto.has_min
+                    and widget_state.value < number_input_proto.min
+                ):
+                    raise StreamlitValueBelowMinError(
+                        value=widget_state.value, min_value=number_input_proto.min
+                    )
+
+                if (
+                    number_input_proto.has_max
+                    and widget_state.value > number_input_proto.max
+                ):
+                    raise StreamlitValueAboveMaxError(
+                        value=widget_state.value, max_value=number_input_proto.max
+                    )
 
                 number_input_proto.value = widget_state.value
             number_input_proto.set_value = True