streamlit-nightly 1.32.3.dev20240325__tar.gz → 1.32.3.dev20240326__tar.gz

{streamlit-nightly-1.32.3.dev20240325 → streamlit-nightly-1.32.3.dev20240326}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: streamlit-nightly
-Version: 1.32.3.dev20240325
+Version: 1.32.3.dev20240326
 Summary: A faster way to build and share data apps
 Home-page: https://streamlit.io
 Author: Snowflake Inc

{streamlit-nightly-1.32.3.dev20240325 → streamlit-nightly-1.32.3.dev20240326}/setup.py

@@ -21,7 +21,7 @@ from setuptools.command.install import install
 
 THIS_DIRECTORY = Path(__file__).parent
 
-VERSION = "1.32.3.dev20240325"  # PEP-440
+VERSION = "1.32.3.dev20240326"  # PEP-440
 
 # IMPORTANT: We should try very hard *not* to add dependencies to Streamlit.
 # And if you do add one, make the required version as general as possible:

{streamlit-nightly-1.32.3.dev20240325 → streamlit-nightly-1.32.3.dev20240326}/streamlit/elements/media.py

@@ -16,6 +16,7 @@ from __future__ import annotations
 
 import io
 import re
+from datetime import timedelta
 from pathlib import Path
 from typing import TYPE_CHECKING, Dict, Final, Union, cast
 
@@ -29,6 +30,7 @@ from streamlit.proto.Audio_pb2 import Audio as AudioProto
 from streamlit.proto.Video_pb2 import Video as VideoProto
 from streamlit.runtime import caching
 from streamlit.runtime.metrics_util import gather_metrics
+from streamlit.runtime.runtime_util import duration_to_seconds
 
 if TYPE_CHECKING:
     from typing import Any
@@ -45,6 +47,16 @@ SubtitleData: TypeAlias = Union[
     str, Path, bytes, io.BytesIO, Dict[str, Union[str, Path, bytes, io.BytesIO]], None
 ]
 
+MediaTime: TypeAlias = Union[int, float, timedelta, str]
+
+TIMEDELTA_PARSE_ERROR_MESSAGE: Final = (
+    "Failed to convert '{param_name}' to a timedelta. "
+    "Please use a string in a format supported by "
+    "[Pandas Timedelta constructor]"
+    "(https://pandas.pydata.org/docs/reference/api/pandas.Timedelta.html), "
+    'e.g. `"10s"`, `"15 seconds"`, or `"1h23s"`. Got: {param_value}'
+)
+
 
 class MediaMixin:
     @gather_metrics("audio")
@@ -52,10 +64,10 @@ class MediaMixin:
         self,
         data: MediaData,
         format: str = "audio/wav",
-        start_time: int = 0,
+        start_time: MediaTime = 0,
         *,
         sample_rate: int | None = None,
-        end_time: int | None = None,
+        end_time: MediaTime | None = None,
         loop: bool = False,
     ) -> DeltaGenerator:
         """Display an audio player.
@@ -111,6 +123,8 @@ class MediaMixin:
            height: 865px
 
         """
+        start_time, end_time = _parse_start_time_end_time(start_time, end_time)
+
         audio_proto = AudioProto()
         coordinates = self.dg._get_delta_path_str()
 
@@ -143,10 +157,10 @@ class MediaMixin:
         self,
         data: MediaData,
         format: str = "video/mp4",
-        start_time: int = 0,
+        start_time: MediaTime = 0,
         *,  # keyword-only arguments:
         subtitles: SubtitleData = None,
-        end_time: int | None = None,
+        end_time: MediaTime | None = None,
         loop: bool = False,
     ) -> DeltaGenerator:
         """Display a video player.
@@ -246,6 +260,9 @@ class MediaMixin:
            for more information.
 
         """
+
+        start_time, end_time = _parse_start_time_end_time(start_time, end_time)
+
         video_proto = VideoProto()
         coordinates = self.dg._get_delta_path_str()
         marshall_video(
@@ -461,6 +478,37 @@ def marshall_video(
                 ) from original_err
 
 
+def _parse_start_time_end_time(
+    start_time: MediaTime, end_time: MediaTime | None
+) -> tuple[int, int | None]:
+    """Parse start_time and end_time and return them as int."""
+
+    try:
+        maybe_start_time = duration_to_seconds(start_time, coerce_none_to_inf=False)
+        if maybe_start_time is None:
+            raise ValueError
+        start_time = int(maybe_start_time)
+    except (StreamlitAPIException, ValueError):
+        error_msg = TIMEDELTA_PARSE_ERROR_MESSAGE.format(
+            param_name="start_time", param_value=start_time
+        )
+        raise StreamlitAPIException(error_msg) from None
+
+    try:
+        # TODO[kajarenc]: Replace `duration_to_seconds` with `time_to_seconds`
+        #  when PR #8343 is merged.
+        end_time = duration_to_seconds(end_time, coerce_none_to_inf=False)
+        if end_time is not None:
+            end_time = int(end_time)
+    except StreamlitAPIException:
+        error_msg = TIMEDELTA_PARSE_ERROR_MESSAGE.format(
+            param_name="end_time", param_value=end_time
+        )
+        raise StreamlitAPIException(error_msg) from None
+
+    return start_time, end_time
+
+
 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)

{streamlit-nightly-1.32.3.dev20240325 → streamlit-nightly-1.32.3.dev20240326}/streamlit/runtime/caching/cache_data_api.py

@@ -35,7 +35,6 @@ from streamlit.runtime.caching.cache_utils import (
     Cache,
     CachedFuncInfo,
     make_cached_func_wrapper,
-    ttl_to_seconds,
 )
 from streamlit.runtime.caching.cached_message_replay import (
     CachedMessageReplayContext,
@@ -59,6 +58,7 @@ from streamlit.runtime.caching.storage.dummy_cache_storage import (
     MemoryCacheStorageManager,
 )
 from streamlit.runtime.metrics_util import gather_metrics
+from streamlit.runtime.runtime_util import duration_to_seconds
 from streamlit.runtime.scriptrunner.script_run_context import get_script_run_ctx
 from streamlit.runtime.stats import CacheStat, CacheStatsProvider, group_stats
 
@@ -154,7 +154,7 @@ class DataCaches(CacheStatsProvider):
         If it doesn't exist, create a new one with the given params.
         """
 
-        ttl_seconds = ttl_to_seconds(ttl, coerce_none_to_inf=False)
+        ttl_seconds = duration_to_seconds(ttl, coerce_none_to_inf=False)
 
         # Get the existing cache, if it exists, and validate that its params
         # haven't changed.
@@ -254,7 +254,7 @@ class DataCaches(CacheStatsProvider):
             CacheStorageContext.
         """
 
-        ttl_seconds = ttl_to_seconds(ttl, coerce_none_to_inf=False)
+        ttl_seconds = duration_to_seconds(ttl, coerce_none_to_inf=False)
 
         cache_context = self.create_cache_storage_context(
             function_key="DUMMY_KEY",

{streamlit-nightly-1.32.3.dev20240325 → streamlit-nightly-1.32.3.dev20240326}/streamlit/runtime/caching/cache_errors.py

@@ -176,14 +176,3 @@ class UnevaluatedDataFrameError(StreamlitAPIException):
     """Used to display a message about uncollected dataframe being used"""
 
     pass
-
-
-class BadTTLStringError(StreamlitAPIException):
-    """Raised when a bad ttl= argument string is passed."""
-
-    def __init__(self, ttl: str):
-        MarkdownFormattedException.__init__(
-            self,
-            "TTL string doesn't look right. It should be formatted as"
-            f"`'1d2h34m'` or `2 days`, for example. Got: {ttl}",
-        )

{streamlit-nightly-1.32.3.dev20240325 → streamlit-nightly-1.32.3.dev20240326}/streamlit/runtime/caching/cache_resource_api.py

@@ -35,7 +35,6 @@ from streamlit.runtime.caching.cache_utils import (
     Cache,
     CachedFuncInfo,
     make_cached_func_wrapper,
-    ttl_to_seconds,
 )
 from streamlit.runtime.caching.cached_message_replay import (
     CachedMessageReplayContext,
@@ -46,6 +45,7 @@ from streamlit.runtime.caching.cached_message_replay import (
 )
 from streamlit.runtime.caching.hashing import HashFuncsDict
 from streamlit.runtime.metrics_util import gather_metrics
+from streamlit.runtime.runtime_util import duration_to_seconds
 from streamlit.runtime.scriptrunner.script_run_context import get_script_run_ctx
 from streamlit.runtime.stats import CacheStat, CacheStatsProvider, group_stats
 
@@ -89,7 +89,7 @@ class ResourceCaches(CacheStatsProvider):
         if max_entries is None:
             max_entries = math.inf
 
-        ttl_seconds = ttl_to_seconds(ttl)
+        ttl_seconds = duration_to_seconds(ttl)
 
         # Get the existing cache, if it exists, and validate that its params
         # haven't changed.

{streamlit-nightly-1.32.3.dev20240325 → streamlit-nightly-1.32.3.dev20240326}/streamlit/runtime/caching/cache_utils.py

@@ -19,20 +19,17 @@ from __future__ import annotations
 import functools
 import hashlib
 import inspect
-import math
 import threading
 import time
 import types
 from abc import abstractmethod
 from collections import defaultdict
-from datetime import timedelta
-from typing import Any, Callable, Final, Literal, overload
+from typing import Any, Callable, Final
 
 from streamlit import type_util
 from streamlit.elements.spinner import spinner
 from streamlit.logger import get_logger
 from streamlit.runtime.caching.cache_errors import (
-    BadTTLStringError,
     CacheError,
     CacheKeyNotFoundError,
     UnevaluatedDataFrameError,
@@ -58,45 +55,6 @@ _LOGGER: Final = get_logger(__name__)
 TTLCACHE_TIMER = time.monotonic
 
 
-@overload
-def ttl_to_seconds(
-    ttl: float | timedelta | str | None, *, coerce_none_to_inf: Literal[False]
-) -> float | None:
-    ...
-
-
-@overload
-def ttl_to_seconds(ttl: float | timedelta | str | None) -> float:
-    ...
-
-
-def ttl_to_seconds(
-    ttl: float | timedelta | str | None, *, coerce_none_to_inf: bool = True
-) -> float | None:
-    """
-    Convert a ttl value to a float representing "number of seconds".
-    """
-    if coerce_none_to_inf and ttl is None:
-        return math.inf
-    if isinstance(ttl, timedelta):
-        return ttl.total_seconds()
-    if isinstance(ttl, str):
-        import numpy as np
-        import pandas as pd
-
-        try:
-            out: float = pd.Timedelta(ttl).total_seconds()
-        except ValueError as ex:
-            raise BadTTLStringError(ttl) from ex
-
-        if np.isnan(out):
-            raise BadTTLStringError(ttl)
-
-        return out
-
-    return ttl
-
-
 # We show a special "UnevaluatedDataFrame" warning for cached funcs
 # that attempt to return one of these unserializable types:
 UNEVALUATED_DATAFRAME_TYPES = (

{streamlit-nightly-1.32.3.dev20240325 → streamlit-nightly-1.32.3.dev20240326}/streamlit/runtime/runtime_util.py

@@ -16,10 +16,12 @@
 
 from __future__ import annotations
 
-from typing import Any
+import math
+from datetime import timedelta
+from typing import Any, Literal, overload
 
 from streamlit import config
-from streamlit.errors import MarkdownFormattedException
+from streamlit.errors import MarkdownFormattedException, StreamlitAPIException
 from streamlit.proto.ForwardMsg_pb2 import ForwardMsg
 from streamlit.runtime.forward_msg_cache import populate_hash_if_needed
 
@@ -54,6 +56,17 @@ of the client's browser and the Streamlit server._
         )
 
 
+class BadDurationStringError(StreamlitAPIException):
+    """Raised when a bad duration argument string is passed."""
+
+    def __init__(self, duration: str):
+        MarkdownFormattedException.__init__(
+            self,
+            "TTL string doesn't look right. It should be formatted as"
+            f"`'1d2h34m'` or `2 days`, for example. Got: {duration}",
+        )
+
+
 def is_cacheable_msg(msg: ForwardMsg) -> bool:
     """True if the given message qualifies for caching."""
     if msg.WhichOneof("type") in {"ref_hash", "initialize"}:
@@ -62,6 +75,45 @@ def is_cacheable_msg(msg: ForwardMsg) -> bool:
     return msg.ByteSize() >= int(config.get_option("global.minCachedMessageSize"))
 
 
+@overload
+def duration_to_seconds(
+    ttl: float | timedelta | str | None, *, coerce_none_to_inf: Literal[False]
+) -> float | None:
+    ...
+
+
+@overload
+def duration_to_seconds(ttl: float | timedelta | str | None) -> float:
+    ...
+
+
+def duration_to_seconds(
+    ttl: float | timedelta | str | None, *, coerce_none_to_inf: bool = True
+) -> float | None:
+    """
+    Convert a ttl value to a float representing "number of seconds".
+    """
+    if coerce_none_to_inf and ttl is None:
+        return math.inf
+    if isinstance(ttl, timedelta):
+        return ttl.total_seconds()
+    if isinstance(ttl, str):
+        import numpy as np
+        import pandas as pd
+
+        try:
+            out: float = pd.Timedelta(ttl).total_seconds()
+        except ValueError as ex:
+            raise BadDurationStringError(ttl) from ex
+
+        if np.isnan(out):
+            raise BadDurationStringError(ttl)
+
+        return out
+
+    return ttl
+
+
 def serialize_forward_msg(msg: ForwardMsg) -> bytes:
     """Serialize a ForwardMsg to send to a client.
 

{streamlit-nightly-1.32.3.dev20240325 → streamlit-nightly-1.32.3.dev20240326}/streamlit/watcher/local_sources_watcher.py

@@ -18,6 +18,7 @@ import collections
 import os
 import sys
 import types
+from pathlib import Path
 from typing import Callable, Final
 
 from streamlit import config, file_util
@@ -165,7 +166,7 @@ class LocalSourcesWatcher:
         for name, paths in module_paths.items():
             for path in paths:
                 if self._file_should_be_watched(path):
-                    self._register_watcher(path, name)
+                    self._register_watcher(str(Path(path).resolve()), name)
 
     def _exclude_blacklisted_paths(self, paths: set[str]) -> set[str]:
         return {p for p in paths if not self._folder_black_list.is_blacklisted(p)}

{streamlit-nightly-1.32.3.dev20240325 → streamlit-nightly-1.32.3.dev20240326}/streamlit_nightly.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: streamlit-nightly
-Version: 1.32.3.dev20240325
+Version: 1.32.3.dev20240326
 Summary: A faster way to build and share data apps
 Home-page: https://streamlit.io
 Author: Snowflake Inc