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

streamlit/elements/lib/column_types.py

@@ -15,9 +15,9 @@
 from __future__ import annotations
 
 import datetime
-from typing import Iterable, List, Union
+from typing import Iterable, Literal, TypedDict
 
-from typing_extensions import Literal, NotRequired, TypeAlias, TypedDict
+from typing_extensions import NotRequired, TypeAlias
 
 from streamlit.runtime.metrics_util import gather_metrics
 
@@ -63,7 +63,7 @@ class CheckboxColumnConfig(TypedDict):
 
 class SelectboxColumnConfig(TypedDict):
     type: Literal["selectbox"]
-    options: NotRequired[List[str | int | float] | None]
+    options: NotRequired[list[str | int | float] | None]
 
 
 class LinkColumnConfig(TypedDict):
@@ -167,22 +167,22 @@ class ColumnConfig(TypedDict, total=False):
     required: bool | None
     default: str | bool | int | float | None
     alignment: Literal["left", "center", "right"] | None
-    type_config: Union[
-        NumberColumnConfig,
-        TextColumnConfig,
-        CheckboxColumnConfig,
-        SelectboxColumnConfig,
-        LinkColumnConfig,
-        ListColumnConfig,
-        DatetimeColumnConfig,
-        DateColumnConfig,
-        TimeColumnConfig,
-        ProgressColumnConfig,
-        LineChartColumnConfig,
-        BarChartColumnConfig,
-        ImageColumnConfig,
-        None,
-    ]
+    type_config: (
+        NumberColumnConfig
+        | TextColumnConfig
+        | CheckboxColumnConfig
+        | SelectboxColumnConfig
+        | LinkColumnConfig
+        | ListColumnConfig
+        | DatetimeColumnConfig
+        | DateColumnConfig
+        | TimeColumnConfig
+        | ProgressColumnConfig
+        | LineChartColumnConfig
+        | BarChartColumnConfig
+        | ImageColumnConfig
+        | None
+    )
 
 
 @gather_metrics("column_config.Column")
@@ -382,7 +382,7 @@ def TextColumn(
     max_chars: int | None = None,
     validate: str | None = None,
 ) -> ColumnConfig:
-    """Configure a text column in ``st.dataframe`` or ``st.data_editor``.
+    r"""Configure a text column in ``st.dataframe`` or ``st.data_editor``.
 
     This is the default column type for string values. This command needs to be used in the
     ``column_config`` parameter of ``st.dataframe`` or ``st.data_editor``. When used with
@@ -525,7 +525,7 @@ def LinkColumn(
 
         * A regular expression (JS flavor, detected by usage of parentheses)
           to extract a part of the URL via a capture group, e.g. ``"https://(.*?)\.streamlit\.app"``
-          to extract the display text "foo" from the URL "\https://foo.streamlit.app".
+          to extract the display text "foo" from the URL "https://foo.streamlit.app".
 
         For more complex cases, you may use `Pandas Styler's format \
         <https://pandas.pydata.org/docs/reference/api/pandas.io.formats.style.Styler.format.html>`_
@@ -562,9 +562,9 @@ def LinkColumn(
     >>>         "apps": st.column_config.LinkColumn(
     >>>             "Trending apps",
     >>>             help="The top trending Streamlit apps",
-    >>>             validate="^https://[a-z]+\.streamlit\.app$",
+    >>>             validate="^https://[a-z]+\\.streamlit\\.app$",
     >>>             max_chars=100,
-    >>>             display_text="https://(.*?)\.streamlit\.app"
+    >>>             display_text="https://(.*?)\\.streamlit\\.app"
     >>>         ),
     >>>         "creator": st.column_config.LinkColumn(
     >>>             "App Creator", display_text="Open profile"

streamlit/elements/lib/dicttools.py

@@ -14,10 +14,12 @@
 
 """Tools for working with dicts."""
 
-from typing import Any, Dict, Mapping, Optional
+from __future__ import annotations
 
+from typing import Any, Mapping
 
-def _unflatten_single_dict(flat_dict):
+
+def _unflatten_single_dict(flat_dict: dict[Any, Any]) -> dict[Any, Any]:
     """Convert a flat dict of key-value pairs to dict tree.
 
     Example
@@ -54,11 +56,11 @@ def _unflatten_single_dict(flat_dict):
         A tree made of dicts inside of dicts.
 
     """
-    out: Dict[str, Any] = dict()
+    out: dict[str, Any] = dict()
     for pathstr, v in flat_dict.items():
         path = pathstr.split("_")
 
-        prev_dict: Optional[Dict[str, Any]] = None
+        prev_dict: dict[str, Any] | None = None
         curr_dict = out
 
         for k in path:
@@ -73,7 +75,9 @@ def _unflatten_single_dict(flat_dict):
     return out
 
 
-def unflatten(flat_dict, encodings=None):
+def unflatten(
+    flat_dict: dict[Any, Any], encodings: set[str] | None = None
+) -> dict[Any, Any]:
     """Converts a flat dict of key-value pairs to a spec tree.
 
     Example
@@ -136,7 +140,7 @@ def unflatten(flat_dict, encodings=None):
     return out_dict
 
 
-def remove_none_values(input_dict: Mapping[Any, Any]) -> Dict[Any, Any]:
+def remove_none_values(input_dict: Mapping[Any, Any]) -> dict[Any, Any]:
     """Remove all keys with None values from a dict."""
     new_dict = {}
     for key, val in input_dict.items():

streamlit/elements/lib/mutable_status_container.py

@@ -16,9 +16,9 @@ from __future__ import annotations
 
 import time
 from types import TracebackType
-from typing import List, Optional, Type, cast
+from typing import Literal, cast
 
-from typing_extensions import Literal, TypeAlias
+from typing_extensions import TypeAlias
 
 from streamlit.cursor import Cursor
 from streamlit.delta_generator import DeltaGenerator, _enqueue_message
@@ -56,7 +56,7 @@ class StatusContainer(DeltaGenerator):
         block_proto.allow_empty = True
         block_proto.expandable.CopyFrom(expandable_proto)
 
-        delta_path: List[int] = (
+        delta_path: list[int] = (
             parent._active_dg._cursor.delta_path if parent._active_dg._cursor else []
         )
 
@@ -90,7 +90,7 @@ class StatusContainer(DeltaGenerator):
         # Initialized in `_create()`:
         self._current_proto: BlockProto | None = None
         self._current_state: States | None = None
-        self._delta_path: List[int] | None = None
+        self._delta_path: list[int] | None = None
 
     def update(
         self,
@@ -158,9 +158,9 @@ class StatusContainer(DeltaGenerator):
 
     def __exit__(
         self,
-        exc_type: Optional[Type[BaseException]],
-        exc_val: Optional[BaseException],
-        exc_tb: Optional[TracebackType],
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
     ) -> Literal[False]:
         # Only update if the current state is running
         if self._current_state == "running":

streamlit/elements/lib/pandas_styler_utils.py

@@ -14,7 +14,7 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any, List, Mapping, TypeVar
+from typing import TYPE_CHECKING, Any, Mapping, TypeVar
 
 from streamlit import type_util
 from streamlit.errors import StreamlitAPIException
@@ -25,7 +25,7 @@ if TYPE_CHECKING:
     from pandas.io.formats.style import Styler
 
 
-def marshall_styler(proto: ArrowProto, styler: "Styler", default_uuid: str) -> None:
+def marshall_styler(proto: ArrowProto, styler: Styler, default_uuid: str) -> None:
     """Marshall pandas.Styler into an Arrow proto.
 
     Parameters
@@ -66,7 +66,7 @@ def marshall_styler(proto: ArrowProto, styler: "Styler", default_uuid: str) -> N
     _marshall_display_values(proto, styler_data_df, pandas_styles)
 
 
-def _marshall_uuid(proto: ArrowProto, styler: "Styler", default_uuid: str) -> None:
+def _marshall_uuid(proto: ArrowProto, styler: Styler, default_uuid: str) -> None:
     """Marshall pandas.Styler uuid into an Arrow proto.
 
     Parameters
@@ -87,7 +87,7 @@ def _marshall_uuid(proto: ArrowProto, styler: "Styler", default_uuid: str) -> No
     proto.styler.uuid = str(styler.uuid)
 
 
-def _marshall_caption(proto: ArrowProto, styler: "Styler") -> None:
+def _marshall_caption(proto: ArrowProto, styler: Styler) -> None:
     """Marshall pandas.Styler caption into an Arrow proto.
 
     Parameters
@@ -104,7 +104,7 @@ def _marshall_caption(proto: ArrowProto, styler: "Styler") -> None:
 
 
 def _marshall_styles(
-    proto: ArrowProto, styler: "Styler", styles: Mapping[str, Any]
+    proto: ArrowProto, styler: Styler, styles: Mapping[str, Any]
 ) -> None:
     """Marshall pandas.Styler styles into an Arrow proto.
 
@@ -147,7 +147,7 @@ def _marshall_styles(
 M = TypeVar("M", bound=Mapping[str, Any])
 
 
-def _trim_pandas_styles(styles: List[M]) -> List[M]:
+def _trim_pandas_styles(styles: list[M]) -> list[M]:
     """Filter out empty styles.
 
     Every cell will have a class, but the list of props

streamlit/elements/lib/streamlit_plotly_theme.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 import contextlib
 
 

streamlit/elements/map.py

@@ -19,18 +19,7 @@ from __future__ import annotations
 import copy
 import hashlib
 import json
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Collection,
-    Dict,
-    Final,
-    Iterable,
-    Set,
-    Tuple,
-    Union,
-    cast,
-)
+from typing import TYPE_CHECKING, Any, Collection, Dict, Final, Iterable, Union, cast
 
 from typing_extensions import TypeAlias
 
@@ -58,7 +47,7 @@ Data: TypeAlias = Union[
 ]
 
 # Map used as the basis for st.map.
-_DEFAULT_MAP: Final[Dict[str, Any]] = dict(deck_gl_json_chart.EMPTY_MAP)
+_DEFAULT_MAP: Final[dict[str, Any]] = dict(deck_gl_json_chart.EMPTY_MAP)
 
 # Other default parameters for st.map.
 _DEFAULT_LAT_COL_NAMES: Final = {"lat", "latitude", "LAT", "LATITUDE"}
@@ -99,11 +88,11 @@ class MapMixin:
         *,
         latitude: str | None = None,
         longitude: str | None = None,
-        color: Union[None, str, Color] = None,
-        size: Union[None, str, float] = None,
+        color: None | str | Color = None,
+        size: None | str | float = None,
         zoom: int | None = None,
         use_container_width: bool = True,
-    ) -> "DeltaGenerator":
+    ) -> DeltaGenerator:
         """Display a map with a scatterplot overlaid onto it.
 
         This is a wrapper around ``st.pydeck_chart`` to quickly create
@@ -247,7 +236,7 @@ class MapMixin:
         return self.dg._enqueue("deck_gl_json_chart", map_proto)
 
     @property
-    def dg(self) -> "DeltaGenerator":
+    def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""
         return cast("DeltaGenerator", self)
 
@@ -327,7 +316,7 @@ def _get_lat_or_lon_col_name(
     data: DataFrame,
     human_readable_name: str,
     col_name_from_user: str | None,
-    default_col_names: Set[str],
+    default_col_names: set[str],
 ) -> str:
     """Returns the column name to be used for latitude or longitude."""
 
@@ -373,7 +362,7 @@ def _get_value_and_col_name(
     data: DataFrame,
     value_or_name: Any,
     default_value: Any,
-) -> Tuple[Any, str | None]:
+) -> tuple[Any, str | None]:
     """Take a value_or_name passed in by the Streamlit developer and return a PyDeck
     argument and column name for that property.
 
@@ -385,7 +374,7 @@ def _get_value_and_col_name(
     - If the user passes size="my_col_123", this returns "@@=my_col_123" and "my_col_123".
     """
 
-    pydeck_arg: Union[str, float]
+    pydeck_arg: str | float
 
     if isinstance(value_or_name, str) and value_or_name in data.columns:
         col_name = value_or_name
@@ -416,7 +405,7 @@ def _convert_color_arg_or_column(
     NOTE: This function mutates the data argument.
     """
 
-    color_arg_out: Union[None, str, IntColorTuple] = None
+    color_arg_out: None | str | IntColorTuple = None
 
     if color_col_name is not None:
         # Convert color column to the right format.
@@ -444,7 +433,7 @@ def _convert_color_arg_or_column(
 
 def _get_viewport_details(
     data: DataFrame, lat_col_name: str, lon_col_name: str, zoom: int | None
-) -> Tuple[int, float, float]:
+) -> tuple[int, float, float]:
     """Auto-set viewport when not fully specified by user."""
     min_lat = data[lat_col_name].min()
     max_lat = data[lat_col_name].max()

streamlit/elements/markdown.py

@@ -12,20 +12,22 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from typing import TYPE_CHECKING, Optional, Union, cast
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Final, cast
 
 from streamlit.proto.Markdown_pb2 import Markdown as MarkdownProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.string_util import clean_text
 from streamlit.type_util import SupportsStr, is_sympy_expession
 
-MARKDOWN_HORIZONTAL_RULE_EXPRESSION = "---"
-
 if TYPE_CHECKING:
     import sympy
 
     from streamlit.delta_generator import DeltaGenerator
 
+MARKDOWN_HORIZONTAL_RULE_EXPRESSION: Final = "---"
+
 
 class MarkdownMixin:
     @gather_metrics("markdown")
@@ -34,8 +36,8 @@ class MarkdownMixin:
         body: SupportsStr,
         unsafe_allow_html: bool = False,
         *,  # keyword-only arguments:
-        help: Optional[str] = None,
-    ) -> "DeltaGenerator":
+        help: str | None = None,
+    ) -> DeltaGenerator:
         r"""Display string formatted as Markdown.
 
         Parameters
@@ -109,8 +111,8 @@ class MarkdownMixin:
     def code(
         self,
         body: SupportsStr,
-        language: Optional[str] = "python",
-    ) -> "DeltaGenerator":
+        language: str | None = "python",
+    ) -> DeltaGenerator:
         """Display a code block with optional syntax highlighting.
 
         (This is a convenience wrapper around `st.markdown()`)
@@ -149,8 +151,8 @@ class MarkdownMixin:
         body: SupportsStr,
         unsafe_allow_html: bool = False,
         *,  # keyword-only arguments:
-        help: Optional[str] = None,
-    ) -> "DeltaGenerator":
+        help: str | None = None,
+    ) -> DeltaGenerator:
         """Display text in small font.
 
         This should be used for captions, asides, footnotes, sidenotes, and
@@ -210,10 +212,10 @@ class MarkdownMixin:
     @gather_metrics("latex")
     def latex(
         self,
-        body: Union[SupportsStr, "sympy.Expr"],
+        body: SupportsStr | sympy.Expr,
         *,  # keyword-only arguments:
-        help: Optional[str] = None,
-    ) -> "DeltaGenerator":
+        help: str | None = None,
+    ) -> DeltaGenerator:
         # This docstring needs to be "raw" because of the backslashes in the
         # example below.
         r"""Display mathematical expressions formatted as LaTeX.
@@ -256,7 +258,7 @@ class MarkdownMixin:
         return self.dg._enqueue("markdown", latex_proto)
 
     @gather_metrics("divider")
-    def divider(self) -> "DeltaGenerator":
+    def divider(self) -> DeltaGenerator:
         """Display a horizontal rule.
 
         .. note::
@@ -276,6 +278,6 @@ class MarkdownMixin:
         return self.dg._enqueue("markdown", divider_proto)
 
     @property
-    def dg(self) -> "DeltaGenerator":
+    def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""
         return cast("DeltaGenerator", self)

streamlit/elements/media.py

@@ -12,11 +12,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 import io
 import re
-from typing import TYPE_CHECKING, Optional, Tuple, Union, cast
+from typing import TYPE_CHECKING, Final, Union, cast
 
-from typing_extensions import Final, TypeAlias
+from typing_extensions import TypeAlias
 
 import streamlit as st
 from streamlit import runtime, type_util, url_util
@@ -46,8 +48,8 @@ class MediaMixin:
         format: str = "audio/wav",
         start_time: int = 0,
         *,
-        sample_rate: Optional[int] = None,
-    ) -> "DeltaGenerator":
+        sample_rate: int | None = None,
+    ) -> DeltaGenerator:
         """Display an audio player.
 
         Parameters
@@ -118,7 +120,7 @@ class MediaMixin:
         data: MediaData,
         format: str = "video/mp4",
         start_time: int = 0,
-    ) -> "DeltaGenerator":
+    ) -> DeltaGenerator:
         """Display a video player.
 
         Parameters
@@ -161,7 +163,7 @@ class MediaMixin:
         return self.dg._enqueue("video", video_proto)
 
     @property
-    def dg(self) -> "DeltaGenerator":
+    def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""
         return cast("DeltaGenerator", self)
 
@@ -178,7 +180,7 @@ YOUTUBE_RE: Final = re.compile(
 )
 
 
-def _reshape_youtube_url(url: str) -> Optional[str]:
+def _reshape_youtube_url(url: str) -> str | None:
     """Return whether URL is any kind of YouTube embed or watch link.  If so,
     reshape URL into an embed link suitable for use in an iframe.
 
@@ -203,7 +205,7 @@ def _reshape_youtube_url(url: str) -> Optional[str]:
 
 def _marshall_av_media(
     coordinates: str,
-    proto: Union[AudioProto, VideoProto],
+    proto: AudioProto | VideoProto,
     data: MediaData,
     mimetype: str,
 ) -> None:
@@ -224,7 +226,7 @@ def _marshall_av_media(
         # Allow empty values so media players can be shown without media.
         return
 
-    data_or_filename: Union[bytes, str]
+    data_or_filename: bytes | str
     if isinstance(data, (str, bytes)):
         # Pass strings and bytes through unchanged
         data_or_filename = data
@@ -299,7 +301,7 @@ def marshall_video(
         _marshall_av_media(coordinates, proto, data, mimetype)
 
 
-def _validate_and_normalize(data: "npt.NDArray[Any]") -> Tuple[bytes, int]:
+def _validate_and_normalize(data: npt.NDArray[Any]) -> tuple[bytes, int]:
     """Validates and normalizes numpy array data.
     We validate numpy array shape (should be 1d or 2d)
     We normalize input data to int16 [-32768, 32767] range.
@@ -321,7 +323,7 @@ def _validate_and_normalize(data: "npt.NDArray[Any]") -> Tuple[bytes, int]:
     # to st.audio data)
     import numpy as np
 
-    data: "npt.NDArray[Any]" = np.array(data, dtype=float)
+    data: npt.NDArray[Any] = np.array(data, dtype=float)
 
     if len(data.shape) == 1:
         nchan = 1
@@ -348,7 +350,7 @@ def _validate_and_normalize(data: "npt.NDArray[Any]") -> Tuple[bytes, int]:
     return scaled_data.tobytes(), nchan
 
 
-def _make_wav(data: "npt.NDArray[Any]", sample_rate: int) -> bytes:
+def _make_wav(data: npt.NDArray[Any], sample_rate: int) -> bytes:
     """
     Transform a numpy array to a PCM bytestring
     We use code from IPython display module to convert numpy array to wave bytes
@@ -369,9 +371,7 @@ def _make_wav(data: "npt.NDArray[Any]", sample_rate: int) -> bytes:
         return fp.getvalue()
 
 
-def _maybe_convert_to_wav_bytes(
-    data: MediaData, sample_rate: Optional[int]
-) -> MediaData:
+def _maybe_convert_to_wav_bytes(data: MediaData, sample_rate: int | None) -> MediaData:
     """Convert data to wav bytes if the data type is numpy array."""
     if type_util.is_type(data, "numpy.ndarray") and sample_rate is not None:
         data = _make_wav(cast("npt.NDArray[Any]", data), sample_rate)
@@ -384,7 +384,7 @@ def marshall_audio(
     data: MediaData,
     mimetype: str = "audio/wav",
     start_time: int = 0,
-    sample_rate: Optional[int] = None,
+    sample_rate: int | None = None,
 ) -> None:
     """Marshalls an audio proto, using data and url processors as needed.
 

streamlit/elements/metric.py

@@ -12,11 +12,13 @@
 # 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, Union, cast
+from typing import TYPE_CHECKING, Literal, Union, cast
 
-from typing_extensions import Literal, TypeAlias
+from typing_extensions import TypeAlias
 
 from streamlit.elements.utils import get_label_visibility_proto_value
 from streamlit.errors import StreamlitAPIException
@@ -38,8 +40,8 @@ DeltaColor: TypeAlias = Literal["normal", "inverse", "off"]
 
 @dataclass(frozen=True)
 class MetricColorAndDirection:
-    color: "MetricProto.MetricColor.ValueType"
-    direction: "MetricProto.MetricDirection.ValueType"
+    color: MetricProto.MetricColor.ValueType
+    direction: MetricProto.MetricDirection.ValueType
 
 
 class MetricMixin:
@@ -50,9 +52,9 @@ class MetricMixin:
         value: Value,
         delta: Delta = None,
         delta_color: DeltaColor = "normal",
-        help: Optional[str] = None,
+        help: str | None = None,
         label_visibility: LabelVisibility = "visible",
-    ) -> "DeltaGenerator":
+    ) -> DeltaGenerator:
         r"""Display a metric in big bold font, with an optional indicator of how the metric changed.
 
         Tip: If you want to display a large number, it may be a good idea to
@@ -165,7 +167,7 @@ class MetricMixin:
         return self.dg._enqueue("metric", metric_proto)
 
     @property
-    def dg(self) -> "DeltaGenerator":
+    def dg(self) -> DeltaGenerator:
         return cast("DeltaGenerator", self)
 
 

streamlit/elements/plotly_chart.py

@@ -18,7 +18,7 @@ from __future__ import annotations
 
 import json
 import urllib.parse
-from typing import TYPE_CHECKING, Any, Dict, List, Literal, Set, Union, cast
+from typing import TYPE_CHECKING, Any, Dict, List, Literal, Union, cast
 
 from typing_extensions import TypeAlias
 
@@ -43,7 +43,7 @@ configure_streamlit_plotly_theme()
 
 SharingMode: TypeAlias = Literal["streamlit", "private", "public", "secret"]
 
-SHARING_MODES: Set[SharingMode] = {
+SHARING_MODES: set[SharingMode] = {
     # This means the plot will be sent to the Streamlit app rather than to
     # Plotly.
     "streamlit",
@@ -79,7 +79,7 @@ class PlotlyMixin:
         sharing: SharingMode = "streamlit",
         theme: Literal["streamlit"] | None = "streamlit",
         **kwargs: Any,
-    ) -> "DeltaGenerator":
+    ) -> DeltaGenerator:
         """Display an interactive Plotly chart.
 
         Plotly is a charting library for Python. The arguments to this function
@@ -164,7 +164,7 @@ class PlotlyMixin:
         return self.dg._enqueue("plotly_chart", plotly_chart_proto)
 
     @property
-    def dg(self) -> "DeltaGenerator":
+    def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""
         return cast("DeltaGenerator", self)
 
@@ -220,7 +220,7 @@ def marshall(
 
 
 @caching.cache
-def _plot_to_url_or_load_cached_url(*args: Any, **kwargs: Any) -> "go.Figure":
+def _plot_to_url_or_load_cached_url(*args: Any, **kwargs: Any) -> go.Figure:
     """Call plotly.plot wrapped in st.cache.
 
     This is so we don't unnecessarily upload data to Plotly's SASS if nothing

streamlit/elements/progress.py

@@ -12,8 +12,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 import math
-from typing import TYPE_CHECKING, Optional, Union, cast
+from typing import TYPE_CHECKING, Union, cast
 
 from typing_extensions import TypeAlias
 
@@ -78,7 +80,7 @@ def _get_value(value):
         )
 
 
-def _get_text(text: Optional[str]) -> Optional[str]:
+def _get_text(text: str | None) -> str | None:
     if text is None:
         return None
     if isinstance(text, str):
@@ -90,9 +92,7 @@ def _get_text(text: Optional[str]) -> Optional[str]:
 
 
 class ProgressMixin:
-    def progress(
-        self, value: FloatOrInt, text: Optional[str] = None
-    ) -> "DeltaGenerator":
+    def progress(self, value: FloatOrInt, text: str | None = None) -> DeltaGenerator:
         r"""Display a progress bar.
 
         Parameters
@@ -157,6 +157,6 @@ class ProgressMixin:
         return self.dg._enqueue("progress", progress_proto)
 
     @property
-    def dg(self) -> "DeltaGenerator":
+    def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""
         return cast("DeltaGenerator", self)