streamlit-nightly 1.31.2.dev20240212__py2.py3-none-any.whl → 1.31.2.dev20240214__py2.py3-none-any.whl

streamlit/elements/widgets/checkbox.py

@@ -12,9 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 from dataclasses import dataclass
 from textwrap import dedent
-from typing import TYPE_CHECKING, Optional, cast
+from typing import TYPE_CHECKING, cast
 
 from streamlit.elements.form import current_form_id
 from streamlit.elements.utils import (
@@ -45,7 +47,7 @@ class CheckboxSerde:
     def serialize(self, v: bool) -> bool:
         return bool(v)
 
-    def deserialize(self, ui_value: Optional[bool], widget_id: str = "") -> bool:
+    def deserialize(self, ui_value: bool | None, widget_id: str = "") -> bool:
         return bool(ui_value if ui_value is not None else self.value)
 
 
@@ -55,11 +57,11 @@ class CheckboxMixin:
         self,
         label: str,
         value: bool = False,
-        key: Optional[Key] = None,
-        help: Optional[str] = None,
-        on_change: Optional[WidgetCallback] = None,
-        args: Optional[WidgetArgs] = None,
-        kwargs: Optional[WidgetKwargs] = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
         *,  # keyword-only arguments:
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
@@ -158,11 +160,11 @@ class CheckboxMixin:
         self,
         label: str,
         value: bool = False,
-        key: Optional[Key] = None,
-        help: Optional[str] = None,
-        on_change: Optional[WidgetCallback] = None,
-        args: Optional[WidgetArgs] = None,
-        kwargs: Optional[WidgetKwargs] = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
         *,  # keyword-only arguments:
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
@@ -260,16 +262,16 @@ class CheckboxMixin:
         self,
         label: str,
         value: bool = False,
-        key: Optional[Key] = None,
-        help: Optional[str] = None,
-        on_change: Optional[WidgetCallback] = None,
-        args: Optional[WidgetArgs] = None,
-        kwargs: Optional[WidgetKwargs] = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
         *,  # keyword-only arguments:
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
         type: CheckboxProto.StyleType.ValueType = CheckboxProto.StyleType.DEFAULT,
-        ctx: Optional[ScriptRunContext] = None,
+        ctx: ScriptRunContext | None = None,
     ) -> bool:
         key = to_key(key)
         check_callback_rules(self.dg, on_change)
@@ -326,6 +328,6 @@ class CheckboxMixin:
         return checkbox_state.value
 
     @property
-    def dg(self) -> "DeltaGenerator":
+    def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""
         return cast("DeltaGenerator", self)

streamlit/elements/widgets/color_picker.py

@@ -12,10 +12,12 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 import re
 from dataclasses import dataclass
 from textwrap import dedent
-from typing import Optional, cast
+from typing import cast
 
 import streamlit
 from streamlit.elements.form import current_form_id
@@ -45,7 +47,7 @@ class ColorPickerSerde:
     def serialize(self, v: str) -> str:
         return str(v)
 
-    def deserialize(self, ui_value: Optional[str], widget_id: str = "") -> str:
+    def deserialize(self, ui_value: str | None, widget_id: str = "") -> str:
         return str(ui_value if ui_value is not None else self.value)
 
 
@@ -54,12 +56,12 @@ class ColorPickerMixin:
     def color_picker(
         self,
         label: str,
-        value: Optional[str] = None,
-        key: Optional[Key] = None,
-        help: Optional[str] = None,
-        on_change: Optional[WidgetCallback] = None,
-        args: Optional[WidgetArgs] = None,
-        kwargs: Optional[WidgetKwargs] = None,
+        value: str | None = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
         *,  # keyword-only arguments:
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
@@ -155,16 +157,16 @@ class ColorPickerMixin:
     def _color_picker(
         self,
         label: str,
-        value: Optional[str] = None,
-        key: Optional[Key] = None,
-        help: Optional[str] = None,
-        on_change: Optional[WidgetCallback] = None,
-        args: Optional[WidgetArgs] = None,
-        kwargs: Optional[WidgetKwargs] = None,
+        value: str | None = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
         *,  # keyword-only arguments:
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
-        ctx: Optional[ScriptRunContext] = None,
+        ctx: ScriptRunContext | None = None,
     ) -> str:
         key = to_key(key)
         check_callback_rules(self.dg, on_change)
@@ -243,6 +245,6 @@ class ColorPickerMixin:
         return widget_state.value
 
     @property
-    def dg(self) -> "streamlit.delta_generator.DeltaGenerator":
+    def dg(self) -> streamlit.delta_generator.DeltaGenerator:
         """Get our DeltaGenerator."""
         return cast("streamlit.delta_generator.DeltaGenerator", self)

streamlit/elements/widgets/data_editor.py

@@ -130,9 +130,9 @@ class EditingState(TypedDict, total=False):
         A list of deleted rows, where each row is the numerical position of the deleted row.
     """
 
-    edited_rows: Dict[int, Dict[str, str | int | float | bool | None]]
-    added_rows: List[Dict[str, str | int | float | bool | None]]
-    deleted_rows: List[int]
+    edited_rows: dict[int, dict[str, str | int | float | bool | None]]
+    added_rows: list[dict[str, str | int | float | bool | None]]
+    deleted_rows: list[int]
 
 
 @dataclass
@@ -281,7 +281,7 @@ def _apply_cell_edits(
 
 def _apply_row_additions(
     df: pd.DataFrame,
-    added_rows: List[Dict[str, Any]],
+    added_rows: list[dict[str, Any]],
     dataframe_schema: DataframeSchema,
 ) -> None:
     """Apply row additions to the provided dataframe (inplace).
@@ -315,7 +315,7 @@ def _apply_row_additions(
 
     for added_row in added_rows:
         index_value = None
-        new_row: List[Any] = [None for _ in range(df.shape[1])]
+        new_row: list[Any] = [None for _ in range(df.shape[1])]
         for col_name in added_row.keys():
             value = added_row[col_name]
             if col_name == INDEX_IDENTIFIER:
@@ -339,7 +339,7 @@ def _apply_row_additions(
             df.loc[index_value, :] = new_row
 
 
-def _apply_row_deletions(df: pd.DataFrame, deleted_rows: List[int]) -> None:
+def _apply_row_deletions(df: pd.DataFrame, deleted_rows: list[int]) -> None:
     """Apply row deletions to the provided dataframe (inplace).
 
     Parameters
@@ -930,7 +930,7 @@ class DataEditorMixin:
         return type_util.convert_df_to_data_format(data_df, data_format)
 
     @property
-    def dg(self) -> "DeltaGenerator":
+    def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""
         return cast("DeltaGenerator", self)
 

streamlit/elements/widgets/file_uploader.py

@@ -11,13 +11,15 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
+
+from __future__ import annotations
+
 from dataclasses import dataclass
 from textwrap import dedent
-from typing import List, Optional, Sequence, Union, cast, overload
+from typing import TYPE_CHECKING, List, Literal, Sequence, Union, cast, overload
 
-from typing_extensions import Literal
+from typing_extensions import TypeAlias
 
-import streamlit
 from streamlit import config
 from streamlit.elements.form import current_form_id
 from streamlit.elements.utils import (
@@ -40,13 +42,17 @@ from streamlit.runtime.state.common import compute_widget_id
 from streamlit.runtime.uploaded_file_manager import DeletedFile, UploadedFile
 from streamlit.type_util import Key, LabelVisibility, maybe_raise_label_warnings, to_key
 
-SomeUploadedFiles = Union[
+if TYPE_CHECKING:
+    from streamlit.delta_generator import DeltaGenerator
+
+SomeUploadedFiles: TypeAlias = Union[
     UploadedFile,
     DeletedFile,
     List[Union[UploadedFile, DeletedFile]],
     None,
 ]
 
+
 TYPE_PAIRS = [
     (".jpg", ".jpeg"),
     (".mpg", ".mpeg"),
@@ -57,8 +63,8 @@ TYPE_PAIRS = [
 
 
 def _get_upload_files(
-    widget_value: Optional[FileUploaderStateProto],
-) -> List[Union[UploadedFile, DeletedFile]]:
+    widget_value: FileUploaderStateProto | None,
+) -> list[UploadedFile | DeletedFile]:
     if widget_value is None:
         return []
 
@@ -77,7 +83,7 @@ def _get_upload_files(
 
     file_recs = {f.file_id: f for f in file_recs_list}
 
-    collected_files: List[Union[UploadedFile, DeletedFile]] = []
+    collected_files: list[UploadedFile | DeletedFile] = []
 
     for f in uploaded_file_info:
         maybe_file_rec = file_recs.get(f.file_id)
@@ -95,7 +101,7 @@ class FileUploaderSerde:
     accept_multiple_files: bool
 
     def deserialize(
-        self, ui_value: Optional[FileUploaderStateProto], widget_id: str
+        self, ui_value: FileUploaderStateProto | None, widget_id: str
     ) -> SomeUploadedFiles:
         upload_files = _get_upload_files(ui_value)
 
@@ -144,17 +150,17 @@ class FileUploaderMixin:
     def file_uploader(
         self,
         label: str,
-        type: Union[str, Sequence[str], None],
+        type: str | Sequence[str] | None,
         accept_multiple_files: Literal[True],
-        key: Optional[Key] = None,
-        help: Optional[str] = None,
-        on_change: Optional[WidgetCallback] = None,
-        args: Optional[WidgetArgs] = None,
-        kwargs: Optional[WidgetKwargs] = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
         *,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
-    ) -> Optional[List[UploadedFile]]:
+    ) -> list[UploadedFile] | None:
         ...
 
     # 1. type is given as not a keyword-only argument
@@ -163,17 +169,17 @@ class FileUploaderMixin:
     def file_uploader(
         self,
         label: str,
-        type: Union[str, Sequence[str], None],
+        type: str | Sequence[str] | None,
         accept_multiple_files: Literal[False] = False,
-        key: Optional[Key] = None,
-        help: Optional[str] = None,
-        on_change: Optional[WidgetCallback] = None,
-        args: Optional[WidgetArgs] = None,
-        kwargs: Optional[WidgetKwargs] = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
         *,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
-    ) -> Optional[UploadedFile]:
+    ) -> UploadedFile | None:
         ...
 
     # The following 2 overloads represent the cases where
@@ -189,15 +195,15 @@ class FileUploaderMixin:
         label: str,
         *,
         accept_multiple_files: Literal[True],
-        type: Union[str, Sequence[str], None] = None,
-        key: Optional[Key] = None,
-        help: Optional[str] = None,
-        on_change: Optional[WidgetCallback] = None,
-        args: Optional[WidgetArgs] = None,
-        kwargs: Optional[WidgetKwargs] = None,
+        type: str | Sequence[str] | None = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
-    ) -> Optional[List[UploadedFile]]:
+    ) -> list[UploadedFile] | None:
         ...
 
     # 1. type is skipped or a keyword argument
@@ -208,32 +214,32 @@ class FileUploaderMixin:
         label: str,
         *,
         accept_multiple_files: Literal[False] = False,
-        type: Union[str, Sequence[str], None] = None,
-        key: Optional[Key] = None,
-        help: Optional[str] = None,
-        on_change: Optional[WidgetCallback] = None,
-        args: Optional[WidgetArgs] = None,
-        kwargs: Optional[WidgetKwargs] = None,
+        type: str | Sequence[str] | None = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
-    ) -> Optional[UploadedFile]:
+    ) -> UploadedFile | None:
         ...
 
     @gather_metrics("file_uploader")
     def file_uploader(
         self,
         label: str,
-        type: Union[str, Sequence[str], None] = None,
+        type: str | Sequence[str] | None = None,
         accept_multiple_files: bool = False,
-        key: Optional[Key] = None,
-        help: Optional[str] = None,
-        on_change: Optional[WidgetCallback] = None,
-        args: Optional[WidgetArgs] = None,
-        kwargs: Optional[WidgetKwargs] = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
         *,  # keyword-only arguments:
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
-    ) -> Union[UploadedFile, List[UploadedFile], None]:
+    ) -> UploadedFile | list[UploadedFile] | None:
         r"""Display a file uploader widget.
         By default, uploaded files are limited to 200MB. You can configure
         this using the `server.maxUploadSize` config option. For more info
@@ -379,18 +385,18 @@ class FileUploaderMixin:
     def _file_uploader(
         self,
         label: str,
-        type: Union[str, Sequence[str], None] = None,
+        type: str | Sequence[str] | None = None,
         accept_multiple_files: bool = False,
-        key: Optional[Key] = None,
-        help: Optional[str] = None,
-        on_change: Optional[WidgetCallback] = None,
-        args: Optional[WidgetArgs] = None,
-        kwargs: Optional[WidgetKwargs] = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
         *,  # keyword-only arguments:
         label_visibility: LabelVisibility = "visible",
         disabled: bool = False,
-        ctx: Optional[ScriptRunContext] = None,
-    ) -> Union[UploadedFile, List[UploadedFile], None]:
+        ctx: ScriptRunContext | None = None,
+    ) -> UploadedFile | list[UploadedFile] | None:
         key = to_key(key)
         check_callback_rules(self.dg, on_change)
         check_session_state_rules(default_value=None, key=key, writes_allowed=False)
@@ -463,8 +469,6 @@ class FileUploaderMixin:
 
         self.dg._enqueue("file_uploader", file_uploader_proto)
 
-        filtered_value: Union[UploadedFile, List[UploadedFile], None]
-
         if isinstance(widget_state.value, DeletedFile):
             return None
         elif isinstance(widget_state.value, list):
@@ -473,6 +477,6 @@ class FileUploaderMixin:
         return widget_state.value
 
     @property
-    def dg(self) -> "streamlit.delta_generator.DeltaGenerator":
+    def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""
-        return cast("streamlit.delta_generator.DeltaGenerator", self)
+        return cast("DeltaGenerator", self)

streamlit/elements/widgets/multiselect.py

@@ -12,20 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 from dataclasses import dataclass
 from textwrap import dedent
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    Generic,
-    List,
-    Optional,
-    Sequence,
-    Union,
-    cast,
-    overload,
-)
+from typing import TYPE_CHECKING, Any, Callable, Generic, Sequence, cast, overload
 
 from streamlit.elements.form import current_form_id
 from streamlit.elements.utils import (
@@ -65,20 +56,20 @@ if TYPE_CHECKING:
 @overload
 def _check_and_convert_to_indices(  # type: ignore[misc]
     opt: Sequence[Any], default_values: None
-) -> Optional[List[int]]:
+) -> list[int] | None:
     ...
 
 
 @overload
 def _check_and_convert_to_indices(
-    opt: Sequence[Any], default_values: Union[Sequence[Any], Any]
-) -> List[int]:
+    opt: Sequence[Any], default_values: Sequence[Any] | Any
+) -> list[int]:
     ...
 
 
 def _check_and_convert_to_indices(
-    opt: Sequence[Any], default_values: Union[Sequence[Any], Any, None]
-) -> Optional[List[int]]:
+    opt: Sequence[Any], default_values: Sequence[Any] | Any | None
+) -> list[int] | None:
     """Perform validation checks and return indices based on the default values."""
     if default_values is None and None not in opt:
         return None
@@ -105,7 +96,7 @@ def _check_and_convert_to_indices(
     return [opt.index(value) for value in default_values]
 
 
-def _get_default_count(default: Union[Sequence[Any], Any, None]) -> int:
+def _get_default_count(default: Sequence[Any] | Any | None) -> int:
     if default is None:
         return 0
     if not is_iterable(default):
@@ -128,17 +119,17 @@ Please select at most {max_selections} {max_selections_noun}.
 @dataclass
 class MultiSelectSerde(Generic[T]):
     options: Sequence[T]
-    default_value: List[int]
+    default_value: list[int]
 
-    def serialize(self, value: List[T]) -> List[int]:
+    def serialize(self, value: list[T]) -> list[int]:
         return _check_and_convert_to_indices(self.options, value)
 
     def deserialize(
         self,
-        ui_value: Optional[List[int]],
+        ui_value: list[int] | None,
         widget_id: str = "",
-    ) -> List[T]:
-        current_value: List[int] = (
+    ) -> list[T]:
+        current_value: list[int] = (
             ui_value if ui_value is not None else self.default_value
         )
         return [self.options[i] for i in current_value]
@@ -150,19 +141,19 @@ class MultiSelectMixin:
         self,
         label: str,
         options: OptionSequence[T],
-        default: Optional[Any] = None,
+        default: Any | None = None,
         format_func: Callable[[Any], Any] = str,
-        key: Optional[Key] = None,
-        help: Optional[str] = None,
-        on_change: Optional[WidgetCallback] = None,
-        args: Optional[WidgetArgs] = None,
-        kwargs: Optional[WidgetKwargs] = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
         *,  # keyword-only arguments:
-        max_selections: Optional[int] = None,
+        max_selections: int | None = None,
         placeholder: str = "Choose an option",
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
-    ) -> List[T]:
+    ) -> list[T]:
         r"""Display a multiselect widget.
         The multiselect widget starts as empty.
 
@@ -276,20 +267,20 @@ class MultiSelectMixin:
         self,
         label: str,
         options: OptionSequence[T],
-        default: Union[Sequence[Any], Any, None] = None,
+        default: Sequence[Any] | Any | None = None,
         format_func: Callable[[Any], Any] = str,
-        key: Optional[Key] = None,
-        help: Optional[str] = None,
-        on_change: Optional[WidgetCallback] = None,
-        args: Optional[WidgetArgs] = None,
-        kwargs: Optional[WidgetKwargs] = None,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
         *,  # keyword-only arguments:
-        max_selections: Optional[int] = None,
+        max_selections: int | None = None,
         placeholder: str = "Choose an option",
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
-        ctx: Optional[ScriptRunContext] = None,
-    ) -> List[T]:
+        ctx: ScriptRunContext | None = None,
+    ) -> list[T]:
         key = to_key(key)
         check_callback_rules(self.dg, on_change)
         check_session_state_rules(default_value=default, key=key)
@@ -314,7 +305,7 @@ class MultiSelectMixin:
             page=ctx.page_script_hash if ctx else None,
         )
 
-        default_value: List[int] = [] if indices is None else indices
+        default_value: list[int] = [] if indices is None else indices
 
         multiselect_proto = MultiSelectProto()
         multiselect_proto.id = id
@@ -360,6 +351,6 @@ class MultiSelectMixin:
         return widget_state.value
 
     @property
-    def dg(self) -> "DeltaGenerator":
+    def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""
         return cast("DeltaGenerator", self)

streamlit/elements/widgets/number_input.py

@@ -17,9 +17,10 @@ from __future__ import annotations
 import numbers
 from dataclasses import dataclass
 from textwrap import dedent
-from typing import Literal, Union, cast, overload
+from typing import TYPE_CHECKING, Literal, Union, cast, overload
+
+from typing_extensions import TypeAlias
 
-import streamlit
 from streamlit.elements.form import current_form_id
 from streamlit.elements.utils import (
     check_callback_rules,
@@ -40,7 +41,11 @@ from streamlit.runtime.state import (
 from streamlit.runtime.state.common import compute_widget_id
 from streamlit.type_util import Key, LabelVisibility, maybe_raise_label_warnings, to_key
 
-Number = Union[int, float]
+if TYPE_CHECKING:
+    from streamlit.delta_generator import DeltaGenerator
+
+
+Number: TypeAlias = Union[int, float]
 
 
 @dataclass
@@ -461,6 +466,6 @@ class NumberInputMixin:
         return widget_state.value
 
     @property
-    def dg(self) -> "streamlit.delta_generator.DeltaGenerator":
+    def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""
-        return cast("streamlit.delta_generator.DeltaGenerator", self)
+        return cast("DeltaGenerator", self)

streamlit/elements/widgets/radio.py

@@ -334,6 +334,6 @@ class RadioMixin:
         return widget_state.value
 
     @property
-    def dg(self) -> "DeltaGenerator":
+    def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""
         return cast("DeltaGenerator", self)