streamlit-nightly 1.36.1.dev20240630__py2.py3-none-any.whl → 1.36.1.dev20240703__py2.py3-none-any.whl

streamlit/errors.py

@@ -108,35 +108,6 @@ class StreamlitAPIWarning(StreamlitAPIException, Warning):
         return util.repr_(self)
 
 
-class StreamlitDeprecationWarning(StreamlitAPIWarning):
-    """Used to display a warning.
-
-    Note that this should not be "raised", but passed to st.exception
-    instead.
-    """
-
-    def __init__(self, config_option, msg, *args):
-        message = """
-{0}
-
-You can disable this warning by disabling the config option:
-`{1}`
-
-```
-st.set_option('{1}', False)
-```
-or in your `.streamlit/config.toml`
-```
-[deprecation]
-{2} = false
-```
-    """.format(msg, config_option, config_option.split(".")[1])
-        super().__init__(message, *args)
-
-    def __repr__(self) -> str:
-        return util.repr_(self)
-
-
 class StreamlitModuleNotFoundError(StreamlitAPIWarning):
     """Print a pretty message when a Streamlit command requires a dependency
     that is not one of our core dependencies."""

streamlit/navigation/page.py

@@ -41,11 +41,16 @@ def Page(
     ``st.navigation`` to declare a page in your app.
 
     When a user navigates to a page, ``st.navigation`` returns the selected
-    ``StreamlitPage`` object. Call ``StreamlitPage.run()`` on the returned page
-    to execute the page. You can only run the page returned by
+    ``StreamlitPage`` object. Call ``.run()`` on the returned ``StreamlitPage``
+    object to execute the page. You can only run the page returned by
     ``st.navigation``, and you can only run it once per app rerun.
 
-    A page can be defined by a Python file or ``Callable``.
+    A page can be defined by a Python file or ``Callable``. Python files used
+    as a ``StreamlitPage`` source will have ``__name__ == "__page__"``.
+    Functions used as a ``StreamlitPage`` source will have ``__name__``
+    corresponding to the module they were imported from. Only the entrypoint
+    file and functions defined within the entrypoint file have
+    ``__name__ == "__main__"`` to adhere to Python convention.
 
     Parameters
     ----------

streamlit/proto/NewSession_pb2.pyi

@@ -211,7 +211,7 @@ class Config(google.protobuf.message.Message):
     hide_top_bar: builtins.bool
     """See config option "ui.hideTopBar"."""
     hide_sidebar_nav: builtins.bool
-    """See config option "ui.hideSidebarNav"."""
+    """See config option "client.showSidebarNavigation"."""
     toolbar_mode: global___Config.ToolbarMode.ValueType
     def __init__(
         self,

streamlit/runtime/app_session.py

@@ -270,8 +270,6 @@ class AppSession:
             The message to enqueue
 
         """
-        if not config.get_option("client.displayEnabled"):
-            return
 
         if self._debug_last_backmsg_id:
             msg.debug_last_backmsg_id = self._debug_last_backmsg_id
@@ -883,8 +881,6 @@ def _populate_config_msg(msg: Config) -> None:
     msg.max_cached_message_age = config.get_option("global.maxCachedMessageAge")
     msg.allow_run_on_save = config.get_option("server.allowRunOnSave")
     msg.hide_top_bar = config.get_option("ui.hideTopBar")
-    # ui.hideSidebarNav is deprecated, will be removed in the future
-    msg.hide_sidebar_nav = config.get_option("ui.hideSidebarNav")
     if config.get_option("client.showSidebarNavigation") is False:
         msg.hide_sidebar_nav = True
     msg.toolbar_mode = _get_toolbar_mode()

streamlit/runtime/caching/cache_utils.py

@@ -26,6 +26,7 @@ from collections import defaultdict
 from typing import TYPE_CHECKING, Any, Callable, Final
 
 from streamlit import type_util
+from streamlit.dataframe_util import UNEVALUATED_DATAFRAME_TYPES
 from streamlit.elements.spinner import spinner
 from streamlit.logger import get_logger
 from streamlit.runtime.caching.cache_errors import (
@@ -44,7 +45,6 @@ from streamlit.runtime.caching.cached_message_replay import (
     replay_cached_messages,
 )
 from streamlit.runtime.caching.hashing import HashFuncsDict, update_hash
-from streamlit.type_util import UNEVALUATED_DATAFRAME_TYPES
 from streamlit.util import HASHLIB_KWARGS
 
 if TYPE_CHECKING:

streamlit/runtime/scriptrunner/script_runner.py

@@ -336,12 +336,7 @@ class ScriptRunner:
         # Whenever we enqueue a ForwardMsg, we also handle any pending
         # execution control request. This means that a script can be
         # cleanly interrupted and stopped inside most `st.foo` calls.
-        #
-        # (If "runner.installTracer" is true, then we'll actually be
-        # handling these requests in a callback called after every Python
-        # instruction instead.)
-        if not config.get_option("runner.installTracer"):
-            self._maybe_handle_execution_control_request()
+        self._maybe_handle_execution_control_request()
 
         # Pass the message to our associated AppSession.
         self.on_event.send(
@@ -382,17 +377,6 @@ class ScriptRunner:
         assert request.type == ScriptRequestType.STOP
         raise StopException()
 
-    def _install_tracer(self) -> None:
-        """Install function that runs before each line of the script."""
-
-        def trace_calls(frame, event, arg):
-            self._maybe_handle_execution_control_request()
-            return trace_calls
-
-        # Python interpreters are not required to implement sys.settrace.
-        if hasattr(sys, "settrace"):
-            sys.settrace(trace_calls)
-
     @contextmanager
     def _set_execing_flag(self):
         """A context for setting the ScriptRunner._execing flag.
@@ -426,8 +410,12 @@ class ScriptRunner:
             start_time: float = timer()
             prep_time: float = 0  # This will be overwritten once preparations are done.
 
-            # Reset DeltaGenerators, widgets, media files.
-            runtime.get_instance().media_file_mgr.clear_session_refs()
+            if not rerun_data.fragment_id_queue:
+                # Don't clear session refs for media files if we're running a fragment.
+                # Otherwise, we're likely to remove files that still have corresponding
+                # download buttons/links to them present in the app, which will result
+                # in a 404 should the user click on them.
+                runtime.get_instance().media_file_mgr.clear_session_refs()
 
             self._pages_manager.set_script_intent(
                 rerun_data.page_script_hash, rerun_data.page_name
@@ -520,9 +508,6 @@ class ScriptRunner:
             # is to run it. Errors thrown during execution will be shown to the
             # user as ExceptionElements.
 
-            if config.get_option("runner.installTracer"):
-                self._install_tracer()
-
             # Create fake module. This gives us a name global namespace to
             # execute the code in.
             module = self._new_module("__main__")

streamlit/runtime/state/common.py

@@ -27,13 +27,16 @@ from typing import (
     Final,
     Generic,
     Iterable,
+    Literal,
     Tuple,
     TypeVar,
     Union,
+    cast,
+    get_args,
 )
 
 from google.protobuf.message import Message
-from typing_extensions import TypeAlias
+from typing_extensions import TypeAlias, TypeGuard
 
 from streamlit import config, util
 from streamlit.errors import StreamlitAPIException
@@ -64,7 +67,6 @@ if TYPE_CHECKING:
 
     from streamlit.runtime.scriptrunner.script_run_context import ScriptRunContext
     from streamlit.runtime.state.widgets import NoValue
-    from streamlit.type_util import ValueFieldName
 
 
 # Protobuf types for all widgets.
@@ -110,6 +112,53 @@ WidgetCallback: TypeAlias = Callable[..., None]
 WidgetDeserializer: TypeAlias = Callable[[Any, str], T]
 WidgetSerializer: TypeAlias = Callable[[T], Any]
 
+# The array value field names are part of the larger set of possible value
+# field names. See the explanation for said set below. The message types
+# associated with these fields are distinguished by storing data in a `data`
+# field in their messages, meaning they need special treatment in certain
+# circumstances. Hence, they need their own, dedicated, sub-type.
+ArrayValueFieldName: TypeAlias = Literal[
+    "double_array_value",
+    "int_array_value",
+    "string_array_value",
+]
+
+# A frozenset containing the allowed values of the ArrayValueFieldName type.
+# Useful for membership checking.
+_ARRAY_VALUE_FIELD_NAMES: Final = frozenset(
+    cast(
+        "tuple[ArrayValueFieldName, ...]",
+        # NOTE: get_args is not recursive, so this only works as long as
+        # ArrayValueFieldName remains flat.
+        get_args(ArrayValueFieldName),
+    )
+)
+
+# These are the possible field names that can be set in the `value` oneof-field
+# of the WidgetState message (schema found in .proto/WidgetStates.proto).
+# We need these as a literal type to ensure correspondence with the protobuf
+# schema in certain parts of the python code.
+# TODO(harahu): It would be preferable if this type was automatically derived
+#  from the protobuf schema, rather than manually maintained. Not sure how to
+#  achieve that, though.
+ValueFieldName: TypeAlias = Literal[
+    ArrayValueFieldName,
+    "arrow_value",
+    "bool_value",
+    "bytes_value",
+    "double_value",
+    "file_uploader_state_value",
+    "int_value",
+    "json_value",
+    "string_value",
+    "trigger_value",
+    "string_trigger_value",
+]
+
+
+def is_array_value_field_name(obj: object) -> TypeGuard[ArrayValueFieldName]:
+    return obj in _ARRAY_VALUE_FIELD_NAMES
+
 
 @dataclass(frozen=True)
 class WidgetMetadata(Generic[T]):

streamlit/runtime/state/session_state.py

@@ -40,13 +40,14 @@ from streamlit.proto.WidgetStates_pb2 import WidgetStates as WidgetStatesProto
 from streamlit.runtime.state.common import (
     RegisterWidgetResult,
     T,
+    ValueFieldName,
     WidgetMetadata,
+    is_array_value_field_name,
     is_keyed_widget_id,
     is_widget_id,
 )
 from streamlit.runtime.state.query_params import QueryParams
 from streamlit.runtime.stats import CacheStat, CacheStatsProvider, group_stats
-from streamlit.type_util import ValueFieldName, is_array_value_field_name
 
 if TYPE_CHECKING:
     from streamlit.runtime.session_manager import SessionManager

streamlit/runtime/state/session_state_proxy.py

@@ -18,11 +18,11 @@ from typing import Any, Final, Iterator, MutableMapping
 
 from streamlit import logger as _logger
 from streamlit import runtime
+from streamlit.elements.lib.utils import Key
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.state.common import require_valid_user_key
 from streamlit.runtime.state.safe_session_state import SafeSessionState
 from streamlit.runtime.state.session_state import SessionState
-from streamlit.type_util import Key
 
 _LOGGER: Final = _logger.get_logger(__name__)
 

streamlit/runtime/state/widgets.py

@@ -25,6 +25,7 @@ from streamlit.proto.WidgetStates_pb2 import WidgetState, WidgetStates
 from streamlit.runtime.state.common import (
     RegisterWidgetResult,
     T,
+    ValueFieldName,
     WidgetArgs,
     WidgetCallback,
     WidgetDeserializer,
@@ -37,7 +38,6 @@ from streamlit.runtime.state.common import (
 
 if TYPE_CHECKING:
     from streamlit.runtime.scriptrunner import ScriptRunContext
-    from streamlit.type_util import ValueFieldName
 
 
 ElementType: TypeAlias = str

streamlit/static/asset-manifest.json

@@ -1,7 +1,7 @@
 {
   "files": {
     "main.css": "./static/css/main.29bca1b5.css",
-    "main.js": "./static/js/main.0326e951.js",
+    "main.js": "./static/js/main.28e3c6e9.js",
     "static/js/9336.3e046ad7.chunk.js": "./static/js/9336.3e046ad7.chunk.js",
     "static/js/9330.2b4c99e0.chunk.js": "./static/js/9330.2b4c99e0.chunk.js",
     "static/js/2736.4336e2b9.chunk.js": "./static/js/2736.4336e2b9.chunk.js",
@@ -151,6 +151,6 @@
   },
   "entrypoints": [
     "static/css/main.29bca1b5.css",
-    "static/js/main.0326e951.js"
+    "static/js/main.28e3c6e9.js"
   ]
 }

streamlit/static/index.html

@@ -1 +1 @@
-<!doctype html><html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width,initial-scale=1,shrink-to-fit=no"/><link rel="shortcut icon" href="./favicon.png"/><link rel="preload" href="./static/media/SourceSansPro-Regular.0d69e5ff5e92ac64a0c9.woff2" as="font" type="font/woff2" crossorigin><link rel="preload" href="./static/media/SourceSansPro-SemiBold.abed79cd0df1827e18cf.woff2" as="font" type="font/woff2" crossorigin><link rel="preload" href="./static/media/SourceSansPro-Bold.118dea98980e20a81ced.woff2" as="font" type="font/woff2" crossorigin><title>Streamlit</title><script>window.prerenderReady=!1</script><script defer="defer" src="./static/js/main.0326e951.js"></script><link href="./static/css/main.29bca1b5.css" rel="stylesheet"></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>
+<!doctype html><html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width,initial-scale=1,shrink-to-fit=no"/><link rel="shortcut icon" href="./favicon.png"/><link rel="preload" href="./static/media/SourceSansPro-Regular.0d69e5ff5e92ac64a0c9.woff2" as="font" type="font/woff2" crossorigin><link rel="preload" href="./static/media/SourceSansPro-SemiBold.abed79cd0df1827e18cf.woff2" as="font" type="font/woff2" crossorigin><link rel="preload" href="./static/media/SourceSansPro-Bold.118dea98980e20a81ced.woff2" as="font" type="font/woff2" crossorigin><title>Streamlit</title><script>window.prerenderReady=!1</script><script defer="defer" src="./static/js/main.28e3c6e9.js"></script><link href="./static/css/main.29bca1b5.css" rel="stylesheet"></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>