streamlit-nightly 1.44.2.dev20250427__py3-none-any.whl → 1.44.2.dev20250428__py3-none-any.whl

streamlit/auth_util.py

@@ -40,7 +40,7 @@ class AuthCache:
 
     # for set method, we are follow the same signature used in Authlib
     # the expires_in is not used in our case
-    def set(self, key, value, expires_in):
+    def set(self, key, value, expires_in):  # noqa: ARG002
         self.cache[key] = value
 
     def get_dict(self):

streamlit/components/v1/custom_component.py

@@ -210,7 +210,7 @@ And if you're using Streamlit Cloud, add "pyarrow" to your requirements.txt."""
                 )
             element.component_instance.id = computed_id
 
-            def deserialize_component(ui_value, widget_id=""):
+            def deserialize_component(ui_value):
                 # ui_value is an object from json, an ArrowTable proto, or a bytearray
                 return ui_value
 

streamlit/config.py

@@ -662,6 +662,20 @@ _create_option(
 
 _create_section("server", "Settings for the Streamlit server")
 
+
+_create_option(
+    "server.folderWatchList",
+    description="""
+        List of folders to watch for changes.
+
+        By default, Streamlit watches for files in the current working directory.
+        Use this parameter to specify additional folders to watch.
+
+        Note: This is a list of absolute paths.
+    """,
+    default_val=[],
+)
+
 _create_option(
     "server.folderWatchBlacklist",
     description="""
@@ -1561,8 +1575,8 @@ 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)
+    # connect to based on window.location.port, which in dev is going
+    # to be (3000)
 
     # Import logger locally to prevent circular references
     from streamlit.logger import get_logger

streamlit/delta_generator.py

@@ -423,7 +423,6 @@ class DeltaGenerator(
         delta_type: str,
         element_proto: Message,
         add_rows_metadata: AddRowsMetadata | None = None,
-        user_key: str | None = None,
     ) -> DeltaGenerator:
         """Create NewElement delta, fill it, and enqueue it.
 
@@ -435,8 +434,6 @@ class DeltaGenerator(
             The actual proto in the NewElement type e.g. Alert/Button/Slider
         add_rows_metadata : AddRowsMetadata or None
             Metadata for the add_rows method
-        user_key : str or None
-            A custom key for the element provided by the user.
 
         Returns
         -------

streamlit/deprecation_util.py

@@ -200,7 +200,7 @@ def _create_deprecated_obj_wrapper(obj: TObj, show_warning: Callable[[], Any]) -
 
         @staticmethod
         def _make_magic_function_proxy(name):
-            def proxy(self, *args):
+            def proxy(self, *args):  # noqa: ARG001
                 maybe_show_warning()
                 return getattr(obj, name)
 

streamlit/elements/arrow.py

@@ -160,7 +160,7 @@ class DataframeState(TypedDict, total=False):
 class DataframeSelectionSerde:
     """DataframeSelectionSerde is used to serialize and deserialize the dataframe selection state."""
 
-    def deserialize(self, ui_value: str | None, widget_id: str = "") -> DataframeState:
+    def deserialize(self, ui_value: str | None) -> DataframeState:
         empty_selection_state: DataframeState = {
             "selection": {
                 "rows": [],

streamlit/elements/code.py

@@ -16,6 +16,7 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, cast
 
+from streamlit.elements.lib.layout_utils import WidthWithoutContent, 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,6 +36,7 @@ class CodeMixin:
         line_numbers: bool = False,
         wrap_lines: bool = False,
         height: int | None = None,
+        width: WidthWithoutContent = "stretch",
     ) -> DeltaGenerator:
         """Display a code block with optional syntax highlighting.
 
@@ -67,6 +69,11 @@ class CodeMixin:
             its content. Vertical scrolling within the element is enabled when
             the height does not accomodate all lines.
 
+        width : "stretch" or int
+            The width of the code block. This can be either:
+            - "stretch" (default): The code block will stretch to fill the container width
+            - An integer: The code block will have a fixed width in pixels
+
         Examples
         --------
         >>> import streamlit as st
@@ -106,6 +113,14 @@ class CodeMixin:
         code_proto.wrap_lines = wrap_lines
         if height:
             code_proto.height = height
+
+        # Set width configuration
+        validate_width(width)
+        if isinstance(width, int):
+            code_proto.width_config.pixel_width = width
+        else:
+            code_proto.width_config.use_stretch = True
+
         return self.dg._enqueue("code", code_proto)
 
     @property

streamlit/elements/deck_gl_json_chart.py

@@ -233,7 +233,7 @@ class PydeckState(TypedDict, total=False):
 class PydeckSelectionSerde:
     """PydeckSelectionSerde is used to serialize and deserialize the Pydeck selection state."""
 
-    def deserialize(self, ui_value: str | None, widget_id: str = "") -> PydeckState:
+    def deserialize(self, ui_value: str | None) -> PydeckState:
         empty_selection_state: PydeckState = {
             "selection": {
                 "indices": {},

streamlit/elements/doc_string.py

@@ -28,7 +28,7 @@ from streamlit.proto.DocString_pb2 import DocString as DocStringProto
 from streamlit.proto.DocString_pb2 import Member as MemberProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner.script_runner import (
-    __file__ as SCRIPTRUNNER_FILENAME,
+    __file__ as SCRIPTRUNNER_FILENAME,  # noqa: N812
 )
 from streamlit.runtime.secrets import Secrets
 from streamlit.string_util import is_mem_address_str
@@ -149,18 +149,14 @@ def _marshall(doc_string_proto: DocStringProto, obj: Any) -> None:
 
 def _get_name(obj):
     # Try to get the fully-qualified name of the object.
-    # For example:
-    #   st.help(bar.Baz(123))
-    #
-    #   The name is bar.Baz
+    # For example: st.help(bar.Baz(123))
+    #    The name is bar.Baz
     name = getattr(obj, "__qualname__", None)
     if name:
         return name
 
     # Try to get the name of the object.
-    # For example:
-    #   st.help(bar.Baz(123))
-    #
+    # For example: st.help(bar.Baz(123))
     #   The name is Baz
     return getattr(obj, "__name__", None)
 
@@ -175,10 +171,6 @@ def _get_signature(obj):
 
     sig = ""
 
-    # TODO: Can we replace below with this?
-    # with contextlib.suppress(ValueError):
-    #     sig = str(inspect.signature(obj))
-
     try:
         sig = str(inspect.signature(obj))
     except ValueError:
@@ -248,20 +240,20 @@ def _get_variable_name_from_code_str(code):
 
     # Example:
     #
-    # tree = Module(
-    #   body=[
-    #     Expr(
-    #       value=Call(
-    #         args=[
-    #           Name(id='the variable name')
-    #         ],
-    #         keywords=[
-    #           ???
-    #         ],
-    #       )
-    #     )
-    #   ]
-    # )
+    # > tree = Module(
+    # >   body=[
+    # >     Expr(
+    # >       value=Call(
+    # >         args=[
+    # >           Name(id='the variable name')
+    # >         ],
+    # >         keywords=[
+    # >           ???
+    # >         ],
+    # >       )
+    # >     )
+    # >   ]
+    # > )
 
     # Check if this is an magic call (i.e. it's not st.help or st.write).
     # If that's the case, just clean it up and return it.

streamlit/elements/lib/built_in_chart_utils.py

@@ -366,8 +366,8 @@ def _infer_vegalite_type(
         return "quantitative"
 
     elif typ == "categorical" and data.cat.ordered:
-        # STREAMLIT MOD: The original code returns a tuple here:
-        # return ("ordinal", data.cat.categories.tolist())
+        # The original code returns a tuple here:
+        # return ("ordinal", data.cat.categories.tolist())  # noqa: ERA001
         # But returning the tuple here isn't compatible with our
         # built-in chart implementation. And it also doesn't seem to be necessary.
         # Altair already extracts the correct sort order somewhere else.
@@ -387,11 +387,11 @@ def _infer_vegalite_type(
         return "temporal"
     else:
         # STREAMLIT MOD: I commented this out since Streamlit doesn't use warnings.warn.
-        # warnings.warn(
-        #     "I don't know how to infer vegalite type from '{}'.  "
-        #     "Defaulting to nominal.".format(typ),
-        #     stacklevel=1,
-        # )
+        # > warnings.warn(
+        # >     "I don't know how to infer vegalite type from '{}'.  "
+        # >     "Defaulting to nominal.".format(typ),
+        # >     stacklevel=1,
+        # > )
         return "nominal"
 
 
@@ -551,7 +551,7 @@ def _melt_data(
         )
 
     # Arrow has problems with object types after melting two different dtypes
-    # pyarrow.lib.ArrowTypeError: "Expected a <TYPE> object, got a object"
+    # > pyarrow.lib.ArrowTypeError: "Expected a <TYPE> object, got a object"
     fixed_df = dataframe_util.fix_arrow_incompatible_column_types(
         melted_df,
         selected_columns=[

streamlit/elements/lib/column_config_utils.py

@@ -188,7 +188,7 @@ def _determine_data_kind_via_arrow(field: pa.Field) -> ColumnDataKind:
 
     # Interval does not seem to work correctly:
     # if pa.types.is_interval(field_type):
-    #     return ColumnDataKind.INTERVAL
+    #     return ColumnDataKind.INTERVAL  # noqa: ERA001
 
     if pa.types.is_binary(field_type):
         return ColumnDataKind.BYTES

streamlit/elements/lib/column_types.py

@@ -12,6 +12,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# Allow function names with uppercase letters:
+# ruff: noqa: N802
+
 from __future__ import annotations
 
 import datetime

streamlit/elements/lib/image_utils.py

@@ -122,7 +122,7 @@ def _validate_image_format_string(
     return "JPEG"
 
 
-def _PIL_to_bytes(
+def _pil_to_bytes(
     image: PILImage,
     format: ImageFormat = "JPEG",
     quality: int = 100,
@@ -139,7 +139,7 @@ def _PIL_to_bytes(
     return tmp.getvalue()
 
 
-def _BytesIO_to_bytes(data: io.BytesIO) -> bytes:
+def _bytesio_to_bytes(data: io.BytesIO) -> bytes:
     data.seek(0)
     return data.getvalue()
 
@@ -151,7 +151,7 @@ def _np_array_to_bytes(array: npt.NDArray[Any], output_format: str = "JPEG") ->
     img = Image.fromarray(array.astype(np.uint8))
     format = _validate_image_format_string(img, output_format)
 
-    return _PIL_to_bytes(img, format)
+    return _pil_to_bytes(img, format)
 
 
 def _verify_np_shape(array: npt.NDArray[Any]) -> npt.NDArray[Any]:
@@ -199,11 +199,11 @@ def _ensure_image_size_and_format(
         # versions. The types don't seem to reflect this, though, hence the type: ignore
         # below.
         pil_image = pil_image.resize((width, new_height), resample=Image.BILINEAR)  # type: ignore[attr-defined]
-        return _PIL_to_bytes(pil_image, format=image_format, quality=90)
+        return _pil_to_bytes(pil_image, format=image_format, quality=90)
 
     if pil_image.format != image_format:
         # We need to reformat the image.
-        return _PIL_to_bytes(pil_image, format=image_format, quality=90)
+        return _pil_to_bytes(pil_image, format=image_format, quality=90)
 
     # No resizing or reformatting necessary - return the original bytes.
     return image_data
@@ -302,13 +302,13 @@ def image_to_url(
     # PIL Images
     elif isinstance(image, (ImageFile.ImageFile, Image.Image)):
         format = _validate_image_format_string(image, output_format)
-        image_data = _PIL_to_bytes(image, format)
+        image_data = _pil_to_bytes(image, format)
 
     # BytesIO
     # Note: This doesn't support SVG. We could convert to png (cairosvg.svg2png)
     # or just decode BytesIO to string and handle that way.
     elif isinstance(image, io.BytesIO):
-        image_data = _BytesIO_to_bytes(image)
+        image_data = _bytesio_to_bytes(image)
 
     # Numpy Arrays (ie opencv)
     elif isinstance(image, np.ndarray):

streamlit/elements/lib/pandas_styler_utils.py

@@ -196,13 +196,13 @@ def _pandas_style_to_css(
 
     # In pandas >= 1.1.0
     # translated_style["cellstyle"] has the following shape:
-    # [
-    #   {
-    #       "props": [("color", " black"), ("background-color", "orange"), ("", "")],
-    #       "selectors": ["row0_col0"]
-    #   }
-    #   ...
-    # ]
+    # > [
+    # >   {
+    # >       "props": [("color", " black"), ("background-color", "orange"), ("", "")],
+    # >       "selectors": ["row0_col0"]
+    # >   }
+    # >   ...
+    # > ]
     if style_type == "table_styles":
         cell_selectors = [style["selector"]]
     else:

streamlit/elements/map.py

@@ -230,7 +230,7 @@ class MapMixin:
         #
         # For reference, this was the docstring for map_style:
         #
-        #   map_style : str or None
+        #   map_style : str, None
         #       One of Mapbox's map style URLs. A full list can be found here:
         #       https://docs.mapbox.com/api/maps/styles/#mapbox-styles
         #

streamlit/elements/plotly_chart.py

@@ -214,7 +214,7 @@ class PlotlyChartSelectionSerde:
     selection state.
     """
 
-    def deserialize(self, ui_value: str | None, widget_id: str = "") -> PlotlyState:
+    def deserialize(self, ui_value: str | None) -> PlotlyState:
         empty_selection_state: PlotlyState = {
             "selection": {
                 "points": [],

streamlit/elements/vega_charts.py

@@ -227,7 +227,7 @@ class VegaLiteStateSerde:
 
     selection_parameters: Sequence[str]
 
-    def deserialize(self, ui_value: str | None, widget_id: str = "") -> VegaLiteState:
+    def deserialize(self, ui_value: str | None) -> VegaLiteState:
         empty_selection_state: VegaLiteState = {
             "selection": AttributeDictionary(
                 # Initialize the select state with empty dictionaries for each selection parameter.
@@ -256,8 +256,8 @@ def _prepare_vega_lite_spec(
     **kwargs,
 ) -> VegaLiteSpec:
     if kwargs:
-        # Support passing in kwargs. Example:
-        #   marshall(proto, {foo: 'bar'}, baz='boz')
+        # Support passing in kwargs.
+        # > marshall(proto, {foo: 'bar'}, baz='boz')
         # Merge spec with unflattened kwargs, where kwargs take precedence.
         # This only works for string keys, but kwarg keys are strings anyways.
         spec = dict(spec, **dicttools.unflatten(kwargs, _CHANNELS))
@@ -313,10 +313,10 @@ def _marshall_chart_data(
         del spec["datasets"]
 
     # Pull data out of spec dict when it's in a top-level 'data' key:
-    #   {data: df}
-    #   {data: {values: df, ...}}
-    #   {data: {url: 'url'}}
-    #   {data: {name: 'foo'}}
+    # > {data: df}
+    # > {data: {values: df, ...}}
+    # > {data: {url: 'url'}}
+    # > {data: {name: 'foo'}}
     if "data" in spec:
         data_spec = spec["data"]
 

streamlit/elements/widgets/audio_input.py

@@ -73,7 +73,7 @@ class AudioInputSerde:
         return state_proto
 
     def deserialize(
-        self, ui_value: FileUploaderStateProto | None, widget_id: str
+        self, ui_value: FileUploaderStateProto | None
     ) -> SomeUploadedAudioFile:
         upload_files = _get_upload_files(ui_value)
         if len(upload_files) == 0:

streamlit/elements/widgets/button.py

@@ -80,7 +80,7 @@ class ButtonSerde:
     def serialize(self, v: bool) -> bool:
         return bool(v)
 
-    def deserialize(self, ui_value: bool | None, widget_id: str = "") -> bool:
+    def deserialize(self, ui_value: bool | None) -> bool:
         return ui_value or False
 
 

streamlit/elements/widgets/button_group.py

@@ -107,11 +107,7 @@ class _MultiSelectSerde(Generic[T]):
         indices = check_and_convert_to_indices(self.options, value)
         return indices if indices is not None else []
 
-    def deserialize(
-        self,
-        ui_value: list[int] | None,
-        widget_id: str = "",
-    ) -> list[T]:
+    def deserialize(self, ui_value: list[int] | None) -> list[T]:
         current_value: list[int] = (
             ui_value if ui_value is not None else self.default_value
         )
@@ -145,8 +141,8 @@ class _SingleSelectSerde(Generic[T]):
         _value = [value] if value is not None else []
         return self.multiselect_serde.serialize(_value)
 
-    def deserialize(self, ui_value: list[int] | None, widget_id: str = "") -> T | None:
-        deserialized = self.multiselect_serde.deserialize(ui_value, widget_id)
+    def deserialize(self, ui_value: list[int] | None) -> T | None:
+        deserialized = self.multiselect_serde.deserialize(ui_value)
 
         if len(deserialized) == 0:
             return None
@@ -182,10 +178,8 @@ class ButtonGroupSerde(Generic[T]):
     def serialize(self, value: T | list[T] | None) -> list[int]:
         return self.serde.serialize(cast("Any", value))
 
-    def deserialize(
-        self, ui_value: list[int] | None, widget_id: str = ""
-    ) -> list[T] | T | None:
-        return self.serde.deserialize(ui_value, widget_id)
+    def deserialize(self, ui_value: list[int] | None) -> list[T] | T | None:
+        return self.serde.deserialize(ui_value)
 
 
 def get_mapped_options(

streamlit/elements/widgets/camera_input.py

@@ -73,7 +73,7 @@ class CameraInputSerde:
         return state_proto
 
     def deserialize(
-        self, ui_value: FileUploaderStateProto | None, widget_id: str
+        self, ui_value: FileUploaderStateProto | None
     ) -> SomeUploadedSnapshotFile:
         upload_files = _get_upload_files(ui_value)
         if len(upload_files) == 0:

streamlit/elements/widgets/chat.py

@@ -196,9 +196,7 @@ class ChatInputSerde:
     allowed_types: Sequence[str] | None = None
 
     def deserialize(
-        self,
-        ui_value: ChatInputValueProto | None,
-        widget_id: str = "",
+        self, ui_value: ChatInputValueProto | None
     ) -> str | ChatInputValue | None:
         if ui_value is None or not ui_value.HasField("data"):
             return None

streamlit/elements/widgets/checkbox.py

@@ -51,7 +51,7 @@ class CheckboxSerde:
     def serialize(self, v: bool) -> bool:
         return bool(v)
 
-    def deserialize(self, ui_value: bool | None, widget_id: str = "") -> bool:
+    def deserialize(self, ui_value: bool | None) -> bool:
         return bool(ui_value if ui_value is not None else self.value)
 
 

streamlit/elements/widgets/color_picker.py

@@ -53,7 +53,7 @@ class ColorPickerSerde:
     def serialize(self, v: str) -> str:
         return str(v)
 
-    def deserialize(self, ui_value: str | None, widget_id: str = "") -> str:
+    def deserialize(self, ui_value: str | None) -> str:
         return str(ui_value if ui_value is not None else self.value)
 
 

streamlit/elements/widgets/data_editor.py

@@ -137,7 +137,7 @@ class EditingState(TypedDict, total=False):
 class DataEditorSerde:
     """DataEditorSerde is used to serialize and deserialize the data editor state."""
 
-    def deserialize(self, ui_value: str | None, widget_id: str = "") -> EditingState:
+    def deserialize(self, ui_value: str | None) -> EditingState:
         data_editor_state: EditingState = (
             {
                 "edited_rows": {},

streamlit/elements/widgets/file_uploader.py

@@ -102,9 +102,7 @@ class FileUploaderSerde:
     accept_multiple_files: bool
     allowed_types: Sequence[str] | None = None
 
-    def deserialize(
-        self, ui_value: FileUploaderStateProto | None, widget_id: str
-    ) -> SomeUploadedFiles:
+    def deserialize(self, ui_value: FileUploaderStateProto | None) -> SomeUploadedFiles:
         upload_files = _get_upload_files(ui_value)
 
         for file in upload_files:

streamlit/elements/widgets/multiselect.py

@@ -116,11 +116,7 @@ class MultiSelectSerde(Generic[T]):
                 values.append(cast("str", v))
         return values
 
-    def deserialize(
-        self,
-        ui_value: list[str] | None,
-        widget_id: str = "",
-    ) -> list[T | str] | list[T]:
+    def deserialize(self, ui_value: list[str] | None) -> list[T | str] | list[T]:
         if ui_value is None:
             return [self.options[i] for i in self.default_options_indices]
 

streamlit/elements/widgets/number_input.py

@@ -70,9 +70,7 @@ class NumberInputSerde:
     def serialize(self, v: Number | None) -> Number | None:
         return v
 
-    def deserialize(
-        self, ui_value: Number | None, widget_id: str = ""
-    ) -> Number | None:
+    def deserialize(self, ui_value: Number | None) -> Number | None:
         val: Number | None = ui_value if ui_value is not None else self.value
 
         if val is not None and self.data_type == NumberInputProto.INT:

streamlit/elements/widgets/radio.py

@@ -66,11 +66,7 @@ class RadioSerde(Generic[T]):
 
         return 0 if len(self.options) == 0 else index_(self.options, v)
 
-    def deserialize(
-        self,
-        ui_value: int | None,
-        widget_id: str = "",
-    ) -> T | None:
+    def deserialize(self, ui_value: int | None) -> T | None:
         idx = ui_value if ui_value is not None else self.index
 
         return (

streamlit/elements/widgets/select_slider.py

@@ -78,11 +78,7 @@ class SelectSliderSerde(Generic[T]):
     def serialize(self, v: object) -> list[int]:
         return self._as_index_list(v)
 
-    def deserialize(
-        self,
-        ui_value: list[int] | None,
-        widget_id: str = "",
-    ) -> T | tuple[T, T]:
+    def deserialize(self, ui_value: list[int] | None) -> T | tuple[T, T]:
         if not ui_value:
             # Widget has not been used; fallback to the original value,
             ui_value = self.value
@@ -128,8 +124,8 @@ class SelectSliderMixin:
     # The overload-overlap error given by mypy here stems from
     # the fact that
     #
-    #   opt:List[object] = [1, 2, "3"]
-    #   select_slider("foo", options=opt, value=[1, 2])
+    # > opt:List[object] = [1, 2, "3"]
+    # > select_slider("foo", options=opt, value=[1, 2])
     #
     # matches both overloads; "opt" matches
     # OptionsSequence[T] in each case, binding T to object.

streamlit/elements/widgets/selectbox.py

@@ -115,11 +115,7 @@ class SelectboxSerde(Generic[T]):
             # options
             return cast("str", v)
 
-    def deserialize(
-        self,
-        ui_value: str | None,
-        widget_id: str = "",
-    ) -> T | str | None:
+    def deserialize(self, ui_value: str | None) -> T | str | None:
         # check if the option is pointing to a generic option type T,
         # otherwise return the option itself
         if ui_value is None:

streamlit/elements/widgets/slider.py

@@ -174,7 +174,7 @@ class SliderSerde:
             )
         return value
 
-    def deserialize(self, ui_value: list[float] | None, widget_id: str = ""):
+    def deserialize(self, ui_value: list[float] | None):
         if ui_value is not None:
             val = ui_value
         else:

streamlit/elements/widgets/text_widgets.py

@@ -54,7 +54,7 @@ if TYPE_CHECKING:
 class TextInputSerde:
     value: str | None
 
-    def deserialize(self, ui_value: str | None, widget_id: str = "") -> str | None:
+    def deserialize(self, ui_value: str | None) -> str | None:
         return ui_value if ui_value is not None else self.value
 
     def serialize(self, v: str | None) -> str | None:
@@ -65,7 +65,7 @@ class TextInputSerde:
 class TextAreaSerde:
     value: str | None
 
-    def deserialize(self, ui_value: str | None, widget_id: str = "") -> str | None:
+    def deserialize(self, ui_value: str | None) -> str | None:
         return ui_value if ui_value is not None else self.value
 
     def serialize(self, v: str | None) -> str | None: