streamlit-nightly 1.38.1.dev20240909__py2.py3-none-any.whl → 1.38.1.dev20240911__py2.py3-none-any.whl

streamlit/elements/lib/utils.py

@@ -16,15 +16,11 @@ from __future__ import annotations
 
 import hashlib
 from datetime import date, datetime, time, timedelta
-from enum import Enum, EnumMeta
 from typing import (
     TYPE_CHECKING,
     Any,
-    Final,
     Iterable,
     Literal,
-    Sequence,
-    TypeVar,
     Union,
     overload,
 )
@@ -32,15 +28,16 @@ from typing import (
 from google.protobuf.message import Message
 from typing_extensions import TypeAlias
 
-from streamlit import config, dataframe_util, errors, logger
+from streamlit import config
 from streamlit.errors import StreamlitDuplicateElementId, StreamlitDuplicateElementKey
 from streamlit.proto.LabelVisibilityMessage_pb2 import LabelVisibilityMessage
 from streamlit.runtime.scriptrunner_utils.script_run_context import (
+    ScriptRunContext,
     get_script_run_ctx,
 )
 from streamlit.runtime.state.common import (
     GENERATED_ELEMENT_ID_PREFIX,
-    RegisterWidgetResult,
+    TESTING_KEY,
     user_key_from_element_id,
 )
 from streamlit.util import HASHLIB_KWARGS
@@ -48,10 +45,6 @@ from streamlit.util import HASHLIB_KWARGS
 if TYPE_CHECKING:
     from builtins import ellipsis
 
-    from streamlit.runtime.state.widgets import NoValue
-    from streamlit.type_util import T
-
-_LOGGER: Final = logger.get_logger(__name__)
 
 Key: TypeAlias = Union[str, int]
 
@@ -64,7 +57,6 @@ SAFE_VALUES = Union[
     datetime,
     timedelta,
     None,
-    "NoValue",
     "ellipsis",
     Message,
     PROTO_SCALAR_VALUE,
@@ -98,163 +90,6 @@ def to_key(key: Key | None) -> str | None:
     return None if key is None else str(key)
 
 
-E1 = TypeVar("E1", bound=Enum)
-E2 = TypeVar("E2", bound=Enum)
-
-_ALLOWED_ENUM_COERCION_CONFIG_SETTINGS = ("off", "nameOnly", "nameAndValue")
-
-
-def _coerce_enum(from_enum_value: E1, to_enum_class: type[E2]) -> E1 | E2:
-    """Attempt to coerce an Enum value to another EnumMeta.
-
-    An Enum value of EnumMeta E1 is considered coercable to EnumType E2
-    if the EnumMeta __qualname__ match and the names of their members
-    match as well. (This is configurable in streamlist configs)
-    """
-    if not isinstance(from_enum_value, Enum):
-        raise ValueError(
-            f"Expected an Enum in the first argument. Got {type(from_enum_value)}"
-        )
-    if not isinstance(to_enum_class, EnumMeta):
-        raise ValueError(
-            f"Expected an EnumMeta/Type in the second argument. Got {type(to_enum_class)}"
-        )
-    if isinstance(from_enum_value, to_enum_class):
-        return from_enum_value  # Enum is already a member, no coersion necessary
-
-    coercion_type = config.get_option("runner.enumCoercion")
-    if coercion_type not in _ALLOWED_ENUM_COERCION_CONFIG_SETTINGS:
-        raise errors.StreamlitAPIException(
-            "Invalid value for config option runner.enumCoercion. "
-            f"Expected one of {_ALLOWED_ENUM_COERCION_CONFIG_SETTINGS}, "
-            f"but got '{coercion_type}'."
-        )
-    if coercion_type == "off":
-        return from_enum_value  # do not attempt to coerce
-
-    # We now know this is an Enum AND the user has configured coercion enabled.
-    # Check if we do NOT meet the required conditions and log a failure message
-    # if that is the case.
-    from_enum_class = from_enum_value.__class__
-    if (
-        from_enum_class.__qualname__ != to_enum_class.__qualname__
-        or (
-            coercion_type == "nameOnly"
-            and set(to_enum_class._member_names_) != set(from_enum_class._member_names_)
-        )
-        or (
-            coercion_type == "nameAndValue"
-            and set(to_enum_class._value2member_map_)
-            != set(from_enum_class._value2member_map_)
-        )
-    ):
-        _LOGGER.debug("Failed to coerce %s to class %s", from_enum_value, to_enum_class)
-        return from_enum_value  # do not attempt to coerce
-
-    # At this point we think the Enum is coercable, and we know
-    # E1 and E2 have the same member names. We convert from E1 to E2 using _name_
-    # (since user Enum subclasses can override the .name property in 3.11)
-    _LOGGER.debug("Coerced %s to class %s", from_enum_value, to_enum_class)
-    return to_enum_class[from_enum_value._name_]
-
-
-@overload
-def maybe_coerce_enum(
-    register_widget_result: RegisterWidgetResult[Enum],
-    options: type[Enum],
-    opt_sequence: Sequence[Any],
-) -> RegisterWidgetResult[Enum]: ...
-
-
-@overload
-def maybe_coerce_enum(
-    register_widget_result: RegisterWidgetResult[T],
-    options: dataframe_util.OptionSequence[T],
-    opt_sequence: Sequence[T],
-) -> RegisterWidgetResult[T]: ...
-
-
-def maybe_coerce_enum(register_widget_result, options, opt_sequence):
-    """Maybe Coerce a RegisterWidgetResult with an Enum member value to
-    RegisterWidgetResult[option] if option is an EnumType, otherwise just return
-    the original RegisterWidgetResult."""
-
-    # If the value is not a Enum, return early
-    if not isinstance(register_widget_result.value, Enum):
-        return register_widget_result
-
-    coerce_class: EnumMeta | None
-    if isinstance(options, EnumMeta):
-        coerce_class = options
-    else:
-        coerce_class = _extract_common_class_from_iter(opt_sequence)
-        if coerce_class is None:
-            return register_widget_result
-
-    return RegisterWidgetResult(
-        _coerce_enum(register_widget_result.value, coerce_class),
-        register_widget_result.value_changed,
-    )
-
-
-# slightly ugly typing because TypeVars with Generic Bounds are not supported
-# (https://github.com/python/typing/issues/548)
-@overload
-def maybe_coerce_enum_sequence(
-    register_widget_result: RegisterWidgetResult[list[T]],
-    options: dataframe_util.OptionSequence[T],
-    opt_sequence: Sequence[T],
-) -> RegisterWidgetResult[list[T]]: ...
-
-
-@overload
-def maybe_coerce_enum_sequence(
-    register_widget_result: RegisterWidgetResult[tuple[T, T]],
-    options: dataframe_util.OptionSequence[T],
-    opt_sequence: Sequence[T],
-) -> RegisterWidgetResult[tuple[T, T]]: ...
-
-
-def maybe_coerce_enum_sequence(register_widget_result, options, opt_sequence):
-    """Maybe Coerce a RegisterWidgetResult with a sequence of Enum members as value
-    to RegisterWidgetResult[Sequence[option]] if option is an EnumType, otherwise just return
-    the original RegisterWidgetResult."""
-
-    # If not all widget values are Enums, return early
-    if not all(isinstance(val, Enum) for val in register_widget_result.value):
-        return register_widget_result
-
-    # Extract the class to coerce
-    coerce_class: EnumMeta | None
-    if isinstance(options, EnumMeta):
-        coerce_class = options
-    else:
-        coerce_class = _extract_common_class_from_iter(opt_sequence)
-        if coerce_class is None:
-            return register_widget_result
-
-    # Return a new RegisterWidgetResult with the coerced enum values sequence
-    return RegisterWidgetResult(
-        type(register_widget_result.value)(
-            _coerce_enum(val, coerce_class) for val in register_widget_result.value
-        ),
-        register_widget_result.value_changed,
-    )
-
-
-def _extract_common_class_from_iter(iterable: Iterable[Any]) -> Any:
-    """Return the common class of all elements in a iterable if they share one.
-    Otherwise, return None."""
-    try:
-        inner_iter = iter(iterable)
-        first_class = type(next(inner_iter))
-    except StopIteration:
-        return None
-    if all(type(item) is first_class for item in inner_iter):
-        return first_class
-    return None
-
-
 def _register_element_id(element_type: str, element_id: str) -> None:
     """Register the element ID and key for the given element.
 
@@ -344,3 +179,11 @@ def compute_and_register_element_id(
     element_id = _compute_element_id(element_type, user_key, **kwargs)
     _register_element_id(element_type, element_id)
     return element_id
+
+
+def save_for_app_testing(ctx: ScriptRunContext, k: str, v: Any):
+    if config.get_option("global.appTest"):
+        try:
+            ctx.session_state[TESTING_KEY][k] = v
+        except KeyError:
+            ctx.session_state[TESTING_KEY] = {k: v}

streamlit/elements/map.py

@@ -22,7 +22,12 @@ from typing import TYPE_CHECKING, Any, Collection, Final, cast
 
 import streamlit.elements.deck_gl_json_chart as deck_gl_json_chart
 from streamlit import config, dataframe_util
-from streamlit.color_util import Color, IntColorTuple, is_color_like, to_int_color_tuple
+from streamlit.elements.lib.color_util import (
+    Color,
+    IntColorTuple,
+    is_color_like,
+    to_int_color_tuple,
+)
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.DeckGlJsonChart_pb2 import DeckGlJsonChart as DeckGlJsonChartProto
 from streamlit.runtime.metrics_util import gather_metrics

streamlit/elements/plotly_chart.py

@@ -36,8 +36,8 @@ from typing_extensions import TypeAlias
 
 from streamlit import type_util
 from streamlit.deprecation_util import show_deprecation_warning
-from streamlit.elements.form_utils import current_form_id
 from streamlit.elements.lib.event_utils import AttributeDictionary
+from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.policies import check_widget_policies
 from streamlit.elements.lib.streamlit_plotly_theme import (
     configure_streamlit_plotly_theme,

streamlit/elements/vega_charts.py

@@ -37,7 +37,6 @@ from typing_extensions import TypeAlias
 
 import streamlit.elements.lib.dicttools as dicttools
 from streamlit import dataframe_util, type_util
-from streamlit.elements.form_utils import current_form_id
 from streamlit.elements.lib.built_in_chart_utils import (
     AddRowsMetadata,
     ChartStackType,
@@ -46,6 +45,7 @@ from streamlit.elements.lib.built_in_chart_utils import (
     maybe_raise_stack_warning,
 )
 from streamlit.elements.lib.event_utils import AttributeDictionary
+from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.policies import check_widget_policies
 from streamlit.elements.lib.utils import Key, compute_and_register_element_id, to_key
 from streamlit.errors import StreamlitAPIException
@@ -60,9 +60,9 @@ from streamlit.util import HASHLIB_KWARGS
 if TYPE_CHECKING:
     import altair as alt
 
-    from streamlit.color_util import Color
     from streamlit.dataframe_util import Data
     from streamlit.delta_generator import DeltaGenerator
+    from streamlit.elements.lib.color_util import Color
 
 # See https://vega.github.io/vega-lite/docs/encoding.html
 _CHANNELS: Final = {

streamlit/elements/widgets/button.py

@@ -31,9 +31,14 @@ from typing import (
 from typing_extensions import TypeAlias
 
 from streamlit import runtime
-from streamlit.elements.form_utils import current_form_id, is_in_form
+from streamlit.elements.lib.form_utils import current_form_id, is_in_form
 from streamlit.elements.lib.policies import check_widget_policies
-from streamlit.elements.lib.utils import Key, compute_and_register_element_id, to_key
+from streamlit.elements.lib.utils import (
+    Key,
+    compute_and_register_element_id,
+    save_for_app_testing,
+    to_key,
+)
 from streamlit.errors import (
     StreamlitAPIException,
     StreamlitMissingPageLabelError,
@@ -53,9 +58,6 @@ from streamlit.runtime.state import (
     WidgetKwargs,
     register_widget,
 )
-from streamlit.runtime.state.common import (
-    save_for_app_testing,
-)
 from streamlit.string_util import validate_icon_or_emoji
 from streamlit.url_util import is_url
 

streamlit/elements/widgets/button_group.py

@@ -26,16 +26,17 @@ from typing import (
     overload,
 )
 
-from streamlit.elements.form_utils import current_form_id
+from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.options_selector_utils import (
     convert_to_sequence_and_check_comparable,
     get_default_indices,
+    maybe_coerce_enum_sequence,
 )
 from streamlit.elements.lib.policies import check_widget_policies
 from streamlit.elements.lib.utils import (
     Key,
     compute_and_register_element_id,
-    maybe_coerce_enum_sequence,
+    save_for_app_testing,
     to_key,
 )
 from streamlit.elements.widgets.multiselect import MultiSelectSerde
@@ -44,12 +45,6 @@ from streamlit.proto.ButtonGroup_pb2 import ButtonGroup as ButtonGroupProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner_utils.script_run_context import get_script_run_ctx
 from streamlit.runtime.state import register_widget
-from streamlit.runtime.state.common import (
-    RegisterWidgetResult,
-    WidgetDeserializer,
-    WidgetSerializer,
-    save_for_app_testing,
-)
 
 if TYPE_CHECKING:
     from streamlit.dataframe_util import OptionSequence
@@ -59,6 +54,11 @@ if TYPE_CHECKING:
         WidgetCallback,
         WidgetKwargs,
     )
+    from streamlit.runtime.state.common import (
+        RegisterWidgetResult,
+        WidgetDeserializer,
+        WidgetSerializer,
+    )
     from streamlit.type_util import T
 
 

streamlit/elements/widgets/camera_input.py

@@ -20,7 +20,7 @@ from typing import TYPE_CHECKING, Union, cast
 
 from typing_extensions import TypeAlias
 
-from streamlit.elements.form_utils import current_form_id
+from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,

streamlit/elements/widgets/chat.py

@@ -20,10 +20,15 @@ from typing import TYPE_CHECKING, Literal, cast
 
 from streamlit import runtime
 from streamlit.delta_generator_singletons import get_dg_singleton_instance
-from streamlit.elements.form_utils import is_in_form
 from streamlit.elements.image import AtomicImage, WidthBehaviour, image_to_url
+from streamlit.elements.lib.form_utils import is_in_form
 from streamlit.elements.lib.policies import check_widget_policies
-from streamlit.elements.lib.utils import Key, compute_and_register_element_id, to_key
+from streamlit.elements.lib.utils import (
+    Key,
+    compute_and_register_element_id,
+    save_for_app_testing,
+    to_key,
+)
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.Block_pb2 import Block as BlockProto
 from streamlit.proto.ChatInput_pb2 import ChatInput as ChatInputProto
@@ -37,9 +42,6 @@ from streamlit.runtime.state import (
     WidgetKwargs,
     register_widget,
 )
-from streamlit.runtime.state.common import (
-    save_for_app_testing,
-)
 from streamlit.string_util import is_emoji, validate_material_icon
 
 if TYPE_CHECKING:

streamlit/elements/widgets/checkbox.py

@@ -18,7 +18,7 @@ from dataclasses import dataclass
 from textwrap import dedent
 from typing import TYPE_CHECKING, cast
 
-from streamlit.elements.form_utils import current_form_id
+from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,

streamlit/elements/widgets/color_picker.py

@@ -19,7 +19,7 @@ from dataclasses import dataclass
 from textwrap import dedent
 from typing import TYPE_CHECKING, cast
 
-from streamlit.elements.form_utils import current_form_id
+from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,

streamlit/elements/widgets/data_editor.py

@@ -39,7 +39,6 @@ from typing_extensions import TypeAlias
 
 from streamlit import dataframe_util
 from streamlit import logger as _logger
-from streamlit.elements.form_utils import current_form_id
 from streamlit.elements.lib.column_config_utils import (
     INDEX_IDENTIFIER,
     ColumnConfigMapping,
@@ -53,6 +52,7 @@ from streamlit.elements.lib.column_config_utils import (
     process_config_mapping,
     update_column_config,
 )
+from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.pandas_styler_utils import marshall_styler
 from streamlit.elements.lib.policies import check_widget_policies
 from streamlit.elements.lib.utils import Key, compute_and_register_element_id, to_key

streamlit/elements/widgets/file_uploader.py

@@ -21,7 +21,7 @@ from typing import TYPE_CHECKING, List, Literal, Sequence, Union, cast, overload
 from typing_extensions import TypeAlias
 
 from streamlit import config
-from streamlit.elements.form_utils import current_form_id
+from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,

streamlit/elements/widgets/multiselect.py

@@ -19,11 +19,12 @@ from textwrap import dedent
 from typing import TYPE_CHECKING, Any, Callable, Generic, Sequence, cast
 
 from streamlit.dataframe_util import OptionSequence
-from streamlit.elements.form_utils import current_form_id
+from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.options_selector_utils import (
     check_and_convert_to_indices,
     convert_to_sequence_and_check_comparable,
     get_default_indices,
+    maybe_coerce_enum_sequence,
 )
 from streamlit.elements.lib.policies import (
     check_widget_policies,
@@ -34,7 +35,7 @@ from streamlit.elements.lib.utils import (
     LabelVisibility,
     compute_and_register_element_id,
     get_label_visibility_proto_value,
-    maybe_coerce_enum_sequence,
+    save_for_app_testing,
     to_key,
 )
 from streamlit.errors import (
@@ -44,9 +45,6 @@ from streamlit.proto.MultiSelect_pb2 import MultiSelect as MultiSelectProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner import ScriptRunContext, get_script_run_ctx
 from streamlit.runtime.state import register_widget
-from streamlit.runtime.state.common import (
-    save_for_app_testing,
-)
 from streamlit.type_util import (
     T,
     is_iterable,

streamlit/elements/widgets/number_input.py

@@ -21,7 +21,8 @@ from typing import TYPE_CHECKING, Literal, TypeVar, Union, cast, overload
 
 from typing_extensions import TypeAlias
 
-from streamlit.elements.form_utils import current_form_id
+from streamlit.elements.lib.form_utils import current_form_id
+from streamlit.elements.lib.js_number import JSNumber, JSNumberBoundsException
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,
@@ -40,7 +41,6 @@ from streamlit.errors import (
     StreamlitValueAboveMaxError,
     StreamlitValueBelowMinError,
 )
-from streamlit.js_number import JSNumber, JSNumberBoundsException
 from streamlit.proto.NumberInput_pb2 import NumberInput as NumberInputProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner import ScriptRunContext, get_script_run_ctx

streamlit/elements/widgets/radio.py

@@ -19,7 +19,8 @@ from textwrap import dedent
 from typing import TYPE_CHECKING, Any, Callable, Generic, Sequence, cast, overload
 
 from streamlit.dataframe_util import OptionSequence, convert_anything_to_list
-from streamlit.elements.form_utils import current_form_id
+from streamlit.elements.lib.form_utils import current_form_id
+from streamlit.elements.lib.options_selector_utils import index_, maybe_coerce_enum
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,
@@ -29,7 +30,7 @@ from streamlit.elements.lib.utils import (
     LabelVisibility,
     compute_and_register_element_id,
     get_label_visibility_proto_value,
-    maybe_coerce_enum,
+    save_for_app_testing,
     to_key,
 )
 from streamlit.errors import StreamlitAPIException
@@ -43,14 +44,10 @@ from streamlit.runtime.state import (
     get_session_state,
     register_widget,
 )
-from streamlit.runtime.state.common import (
-    save_for_app_testing,
-)
 from streamlit.type_util import (
     T,
     check_python_comparable,
 )
-from streamlit.util import index_
 
 if TYPE_CHECKING:
     from streamlit.delta_generator import DeltaGenerator

streamlit/elements/widgets/select_slider.py

@@ -30,7 +30,12 @@ from typing import (
 from typing_extensions import TypeGuard
 
 from streamlit.dataframe_util import OptionSequence, convert_anything_to_list
-from streamlit.elements.form_utils import current_form_id
+from streamlit.elements.lib.form_utils import current_form_id
+from streamlit.elements.lib.options_selector_utils import (
+    index_,
+    maybe_coerce_enum,
+    maybe_coerce_enum_sequence,
+)
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,
@@ -40,8 +45,7 @@ from streamlit.elements.lib.utils import (
     LabelVisibility,
     compute_and_register_element_id,
     get_label_visibility_proto_value,
-    maybe_coerce_enum,
-    maybe_coerce_enum_sequence,
+    save_for_app_testing,
     to_key,
 )
 from streamlit.errors import StreamlitAPIException
@@ -56,10 +60,8 @@ from streamlit.runtime.state import (
 )
 from streamlit.runtime.state.common import (
     RegisterWidgetResult,
-    save_for_app_testing,
 )
 from streamlit.type_util import T, check_python_comparable
-from streamlit.util import index_
 
 if TYPE_CHECKING:
     from streamlit.delta_generator import DeltaGenerator

streamlit/elements/widgets/selectbox.py

@@ -18,7 +18,8 @@ from textwrap import dedent
 from typing import TYPE_CHECKING, Any, Callable, Generic, Sequence, cast, overload
 
 from streamlit.dataframe_util import OptionSequence, convert_anything_to_list
-from streamlit.elements.form_utils import current_form_id
+from streamlit.elements.lib.form_utils import current_form_id
+from streamlit.elements.lib.options_selector_utils import index_, maybe_coerce_enum
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,
@@ -28,7 +29,7 @@ from streamlit.elements.lib.utils import (
     LabelVisibility,
     compute_and_register_element_id,
     get_label_visibility_proto_value,
-    maybe_coerce_enum,
+    save_for_app_testing,
     to_key,
 )
 from streamlit.errors import StreamlitAPIException
@@ -42,14 +43,10 @@ from streamlit.runtime.state import (
     get_session_state,
     register_widget,
 )
-from streamlit.runtime.state.common import (
-    save_for_app_testing,
-)
 from streamlit.type_util import (
     T,
     check_python_comparable,
 )
-from streamlit.util import index_
 
 if TYPE_CHECKING:
     from streamlit.delta_generator import DeltaGenerator

streamlit/elements/widgets/slider.py

@@ -33,7 +33,8 @@ from typing import (
 
 from typing_extensions import TypeAlias
 
-from streamlit.elements.form_utils import current_form_id
+from streamlit.elements.lib.form_utils import current_form_id
+from streamlit.elements.lib.js_number import JSNumber, JSNumberBoundsException
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,
@@ -46,7 +47,6 @@ from streamlit.elements.lib.utils import (
     to_key,
 )
 from streamlit.errors import StreamlitAPIException
-from streamlit.js_number import JSNumber, JSNumberBoundsException
 from streamlit.proto.Slider_pb2 import Slider as SliderProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner import ScriptRunContext, get_script_run_ctx

streamlit/elements/widgets/text_widgets.py

@@ -18,7 +18,7 @@ from dataclasses import dataclass
 from textwrap import dedent
 from typing import TYPE_CHECKING, Literal, cast, overload
 
-from streamlit.elements.form_utils import current_form_id
+from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,

streamlit/elements/widgets/time_widgets.py

@@ -32,7 +32,7 @@ from typing import (
 
 from typing_extensions import TypeAlias
 
-from streamlit.elements.form_utils import current_form_id
+from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,

streamlit/errors.py

@@ -430,3 +430,25 @@ class StreamlitValueAssignmentNotAllowedError(LocalizableStreamlitException):
             "Values for the widget with `key` '{key}' cannot be set using `st.session_state`.",
             key=key,
         )
+
+
+class StreamlitInvalidColorError(LocalizableStreamlitException):
+    def __init__(self, color):
+        super().__init__(
+            "This does not look like a valid color: {color}.\n\n"
+            "Colors must be in one of the following formats:"
+            "* Hex string with 3, 4, 6, or 8 digits. Example: `'#00ff00'`"
+            "* List or tuple with 3 or 4 components. Example: `[1.0, 0.5, 0, 0.2]`",
+            color=repr(color),
+        )
+
+
+class StreamlitBadTimeStringError(LocalizableStreamlitException):
+    """Exception Raised when a time string argument is passed that cannot be parsed."""
+
+    def __init__(self, time_string: str):
+        super().__init__(
+            "Time string doesn't look right. It should be formatted as"
+            "`'1d2h34m'` or `2 days`, for example. Got: {time_string}",
+            time_string=time_string,
+        )