streamlit-nightly 1.36.1.dev20240629__py2.py3-none-any.whl → 1.36.1.dev20240702__py2.py3-none-any.whl

streamlit/commands/navigation.py

@@ -69,7 +69,7 @@ def navigation(
     ``streamlit run``) acts like a router or frame of common elements around
     each of your pages. Streamlit executes the entrypoint file with every app
     rerun. To execute the current page, you must call the ``.run()`` method on
-    the page object returned by ``st.navigation``.
+    the ``StreamlitPage`` object returned by ``st.navigation``.
 
     The set of available pages can be updated with each rerun for dynamic
     navigation. By default, ``st.navigation`` draws the available pages in the

streamlit/config.py

@@ -95,8 +95,6 @@ def set_user_option(key: str, value: Any) -> None:
 
     Currently, only the following config options can be set within the script itself:
         * client.caching
-        * client.displayEnabled
-        * deprecation.*
 
     Calling with any other options will raise StreamlitAPIException.
 
@@ -270,23 +268,6 @@ def _delete_option(key: str) -> None:
 
 _create_section("global", "Global options that apply across all of Streamlit.")
 
-_create_option(
-    "global.disableWatchdogWarning",
-    description="""
-        By default, Streamlit checks if the Python watchdog module is available
-        and, if not, prints a warning asking for you to install it. The watchdog
-        module is not required, but highly recommended. It improves Streamlit's
-        ability to detect changes to files in your filesystem.
-
-        If you'd like to turn off this warning, set this to True.
-        """,
-    default_val=False,
-    type_=bool,
-    deprecated=True,
-    deprecation_text="global.disableWatchdogWarning has been deprecated and will be removed in a future version.",
-    expiration_date="2024-01-20",
-)
-
 
 _create_option(
     "global.disableWidgetStateDuplicationWarning",
@@ -328,18 +309,6 @@ def _global_development_mode() -> bool:
     )
 
 
-_create_option(
-    "global.logLevel",
-    description="""Level of logging: 'error', 'warning', 'info', or 'debug'.
-
-    Default: 'info'
-    """,
-    deprecated=True,
-    deprecation_text="global.logLevel has been replaced with logger.level",
-    expiration_date="2020-11-30",
-    replaced_by="logger.level",
-)
-
 _create_option(
     "global.e2eTest",
     description="Are we in an e2e (playwright) test? Set automatically when our e2e tests are running.",
@@ -401,21 +370,6 @@ _create_option(
     type_=bool,
 )
 
-_create_option(
-    "global.dataFrameSerialization",
-    description="""
-        DataFrame serialization.
-
-        Acceptable values:
-        - 'legacy': Serialize DataFrames using Streamlit's custom format. Slow
-          but battle-tested.
-        - 'arrow': Serialize DataFrames using Apache Arrow. Much faster and versatile.""",
-    default_val="arrow",
-    type_=str,
-    deprecated=True,
-    deprecation_text="Legacy serialization has been removed. All dataframes will be serialized using Apache Arrow.",
-    expiration_date="2023-11-01",
-)
 
 # Config Section: Logger #
 _create_section("logger", "Settings to customize Streamlit log messages.")
@@ -427,9 +381,7 @@ def _logger_log_level() -> str:
 
     Default: 'info'
     """
-    if get_option("global.logLevel"):
-        return str(get_option("global.logLevel"))
-    elif get_option("global.developmentMode"):
+    if get_option("global.developmentMode"):
         return "debug"
     else:
         return "info"
@@ -471,17 +423,6 @@ _create_option(
 
 _create_section("client", "Settings for scripts that use Streamlit.")
 
-_create_option(
-    "client.displayEnabled",
-    description="""If false, makes your Streamlit script not draw to a
-        Streamlit app.""",
-    default_val=True,
-    type_=bool,
-    scriptable=True,
-    deprecated=True,
-    deprecation_text="client.displayEnabled has been deprecated and will be removed in a future version.",
-    expiration_date="2024-01-20",
-)
 
 _create_option(
     "client.showErrorDetails",
@@ -544,33 +485,6 @@ _create_option(
     type_=bool,
 )
 
-_create_option(
-    "runner.installTracer",
-    description="""
-        Install a Python tracer to allow you to stop or pause your script at
-        any point and introspect it. As a side-effect, this slows down your
-        script's execution.
-        """,
-    default_val=False,
-    type_=bool,
-    deprecated=True,
-    deprecation_text="runner.installTracer has been deprecated and will be removed in a future version.",
-    expiration_date="2024-01-20",
-)
-
-_create_option(
-    "runner.fixMatplotlib",
-    description="""
-        Sets the MPLBACKEND environment variable to Agg inside Streamlit to
-        prevent Python crashing.
-        """,
-    default_val=True,
-    deprecated=True,
-    deprecation_text="runner.fixMatplotlib has been deprecated and will be removed in a future version.",
-    expiration_date="2024-01-20",
-    type_=bool,
-)
-
 _create_option(
     "runner.postScriptGC",
     description="""
@@ -925,17 +839,6 @@ _create_option(
     visibility="hidden",
 )
 
-_create_option(
-    "ui.hideSidebarNav",
-    description="Flag to hide the sidebar page navigation component.",
-    default_val=False,
-    type_=bool,
-    deprecated=True,
-    deprecation_text="ui.hideSidebarNav has been deprecated and replaced with client.showSidebarNavigation. It will be removed in a future version.",
-    expiration_date="2024-01-20",
-    visibility="hidden",
-)
-
 
 # Config Section: Mapbox #
 
@@ -982,44 +885,6 @@ _create_option(
 )
 
 
-# Config Section: deprecations
-
-_create_section("deprecation", "Configuration to show or hide deprecation warnings.")
-
-_create_option(
-    "deprecation.showfileUploaderEncoding",
-    description="Set to false to disable the deprecation warning for the file uploader encoding.",
-    default_val=True,
-    scriptable=True,
-    type_=bool,
-    deprecated=True,
-    deprecation_text="deprecation.showfileUploaderEncoding has been deprecated and will be removed in a future version.",
-    expiration_date="2021-01-06",
-)
-
-_create_option(
-    "deprecation.showImageFormat",
-    description="Set to false to disable the deprecation warning for the image format parameter.",
-    default_val=True,
-    scriptable=True,
-    type_=bool,
-    deprecated=True,
-    deprecation_text="The format parameter for st.image has been removed.",
-    expiration_date="2021-03-24",
-)
-
-_create_option(
-    "deprecation.showPyplotGlobalUse",
-    description="Set to false to disable the deprecation warning for using the global pyplot instance.",
-    default_val=True,
-    scriptable=True,
-    deprecated=True,
-    deprecation_text="The support for global pyplot instances is planned to be removed soon.",
-    expiration_date="2024-04-15",
-    type_=bool,
-)
-
-
 # Config Section: Custom Theme #
 
 _create_section("theme", "Settings to define a custom theme for your Streamlit app.")

streamlit/elements/dialog_decorator.py

@@ -110,7 +110,7 @@ def dialog_decorator(
     app should generally be stored in Session State.
 
     A user can dismiss a modal dialog by clicking outside of it, clicking the
-    "**X**" in its upper-right corner, or pressing``ESC`` on their keyboard.
+    "**X**" in its upper-right corner, or pressing ``ESC`` on their keyboard.
     Dismissing a modal dialog does not trigger an app rerun. To close the modal
     dialog programmatically, call ``st.rerun()`` explicitly inside of the
     dialog function.

streamlit/elements/exception.py

@@ -23,7 +23,6 @@ from streamlit.errors import (
     MarkdownFormattedException,
     StreamlitAPIException,
     StreamlitAPIWarning,
-    StreamlitDeprecationWarning,
     UncaughtAppException,
 )
 from streamlit.logger import get_logger
@@ -88,16 +87,11 @@ def marshall(exception_proto: ExceptionProto, exception: BaseException) -> None:
     # If this is a StreamlitAPIException, we prune all Streamlit entries
     # from the exception's stack trace.
     is_api_exception = isinstance(exception, StreamlitAPIException)
-    is_deprecation_exception = isinstance(exception, StreamlitDeprecationWarning)
     is_markdown_exception = isinstance(exception, MarkdownFormattedException)
     is_uncaught_app_exception = isinstance(exception, UncaughtAppException)
 
-    stack_trace = (
-        []
-        if is_deprecation_exception
-        else _get_stack_trace_str_list(
-            exception, strip_streamlit_stack_entries=is_api_exception
-        )
+    stack_trace = _get_stack_trace_str_list(
+        exception, strip_streamlit_stack_entries=is_api_exception
     )
 
     # Some exceptions (like UserHashError) have an alternate_name attribute so

streamlit/elements/image.py

@@ -205,6 +205,7 @@ def _validate_image_format_string(
     if format == "JPG":
         return "JPEG"
 
+    pil_image: PILImage
     if isinstance(image_data, bytes):
         from PIL import Image
 
@@ -287,7 +288,7 @@ def _ensure_image_size_and_format(
     """
     from PIL import Image
 
-    pil_image = Image.open(io.BytesIO(image_data))
+    pil_image: PILImage = Image.open(io.BytesIO(image_data))
     actual_width, actual_height = pil_image.size
 
     if width < 0 and actual_width > MAXIMUM_CONTENT_WIDTH:

streamlit/elements/media.py

@@ -95,7 +95,7 @@ class MediaMixin:
             one of the following:
 
             * ``None`` (default): The element plays from the beginning.
-            * An``int`` or ``float`` specifying the time in seconds. ``float``
+            * An ``int`` or ``float`` specifying the time in seconds. ``float``
               values are rounded down to whole seconds.
             * A string specifying the time in a format supported by `Pandas'
               Timedelta constructor <https://pandas.pydata.org/docs/reference/api/pandas.Timedelta.html>`_,

streamlit/elements/pyplot.py

@@ -20,8 +20,7 @@ import io
 from typing import TYPE_CHECKING, Any, cast
 
 import streamlit.elements.image as image_utils
-from streamlit import config
-from streamlit.errors import StreamlitDeprecationWarning
+from streamlit.deprecation_util import show_deprecation_warning
 from streamlit.proto.Image_pb2 import ImageList as ImageListProto
 from streamlit.runtime.metrics_util import gather_metrics
 
@@ -45,9 +44,13 @@ class PyplotMixin:
         Parameters
         ----------
         fig : Matplotlib Figure
-            The figure to plot. When this argument isn't specified, this
-            function will render the global figure (but this is deprecated,
-            as described below)
+            The Matplotlib ``Figure`` object to render. See
+            https://matplotlib.org/stable/gallery/index.html for examples.
+
+            .. note::
+                When this argument isn't specified, this function will render the global
+                Matplotlib figure object. However, this feature is deprecated and
+                will be removed in a later version.
 
         clear_figure : bool
             If True, the figure will be cleared after being rendered.
@@ -87,15 +90,6 @@ class PyplotMixin:
            https://doc-pyplot.streamlit.app/
            height: 630px
 
-        Notes
-        -----
-        .. note::
-           Deprecation warning. After December 1st, 2020, we will remove the ability
-           to specify no arguments in `st.pyplot()`, as that requires the use of
-           Matplotlib's global figure object, which is not thread-safe. So
-           please always pass a figure object as shown in the example section
-           above.
-
         Matplotlib supports several types of "backends". If you're getting an
         error using Matplotlib with Streamlit, try setting your backend to "TkAgg"::
 
@@ -105,8 +99,24 @@ class PyplotMixin:
 
         """
 
-        if not fig and config.get_option("deprecation.showPyplotGlobalUse"):
-            self.dg.exception(PyplotGlobalUseWarning())
+        if not fig:
+            show_deprecation_warning("""
+Calling `st.pyplot()` without providing a figure argument has been deprecated
+and will be removed in a later version as it requires the use of Matplotlib's
+global figure object, which is not thread-safe.
+
+To future-proof this code, you should pass in a figure as shown below:
+
+```python
+fig, ax = plt.subplots()
+ax.scatter([1, 2, 3], [1, 2, 3])
+# other plotting actions...
+st.pyplot(fig)
+```
+
+If you have a specific use case that requires this functionality, please let us
+know via [issue on Github](https://github.com/streamlit/streamlit/issues).
+""")
 
         image_list_proto = ImageListProto()
         marshall(
@@ -181,26 +191,3 @@ def marshall(
     # plt calls will be starting fresh.
     if clear_figure:
         fig.clf()
-
-
-class PyplotGlobalUseWarning(StreamlitDeprecationWarning):
-    def __init__(self) -> None:
-        super().__init__(
-            msg=self._get_message(), config_option="deprecation.showPyplotGlobalUse"
-        )
-
-    def _get_message(self) -> str:
-        return """
-You are calling `st.pyplot()` without any arguments. After December 1st, 2020,
-we will remove the ability to do this as it requires the use of Matplotlib's global
-figure object, which is not thread-safe.
-
-To future-proof this code, you should pass in a figure as shown below:
-
-```python
->>> fig, ax = plt.subplots()
->>> ax.scatter([1, 2, 3], [1, 2, 3])
->>>    ... other plotting actions ...
->>> st.pyplot(fig)
-```
-"""

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/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/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.e2ab315a.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.e2ab315a.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.e2ab315a.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>