streamlit-nightly 1.31.2.dev20240219__tar.gz → 1.31.2.dev20240221__tar.gz

{streamlit-nightly-1.31.2.dev20240219/streamlit_nightly.egg-info → streamlit-nightly-1.31.2.dev20240221}/PKG-INFO

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

{streamlit-nightly-1.31.2.dev20240219 → streamlit-nightly-1.31.2.dev20240221}/setup.py

@@ -21,7 +21,7 @@ from setuptools.command.install import install
 
 THIS_DIRECTORY = Path(__file__).parent
 
-VERSION = "1.31.2.dev20240219"  # PEP-440
+VERSION = "1.31.2.dev20240221"  # 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.31.2.dev20240219 → streamlit-nightly-1.31.2.dev20240221}/streamlit/__init__.py

@@ -175,6 +175,7 @@ multiselect = _main.multiselect
 number_input = _main.number_input
 page_link = _main.page_link
 plotly_chart = _main.plotly_chart
+popover = _main.popover
 progress = _main.progress
 pyplot = _main.pyplot
 radio = _main.radio

{streamlit-nightly-1.31.2.dev20240219 → streamlit-nightly-1.31.2.dev20240221}/streamlit/delta_generator.py

@@ -610,6 +610,10 @@ class DeltaGenerator(
             raise StreamlitAPIException(
                 "Expanders may not be nested inside other expanders."
             )
+        if block_type == "popover" and block_type in frozenset(parent_block_types):
+            raise StreamlitAPIException(
+                "Popovers may not be nested inside other popovers."
+            )
 
         if dg._root_container is None or dg._cursor is None:
             return dg

{streamlit-nightly-1.31.2.dev20240219 → streamlit-nightly-1.31.2.dev20240221}/streamlit/elements/layouts.py

@@ -40,7 +40,7 @@ class LayoutsMixin:
         multiple elements. This allows you to, for example, insert multiple
         elements into your app out of order.
 
-        To add elements to the returned container, you can use "with" notation
+        To add elements to the returned container, you can use the "with" notation
         (preferred) or just call methods directly on the returned object. See
         examples below.
 
@@ -141,7 +141,6 @@ class LayoutsMixin:
 
         return self.dg._block(block_proto)
 
-    # TODO: Enforce that columns are not nested or in Sidebar
     @gather_metrics("columns")
     def columns(
         self, spec: SpecType, *, gap: str | None = "small"
@@ -151,7 +150,7 @@ class LayoutsMixin:
         Inserts a number of multi-element containers laid out side-by-side and
         returns a list of container objects.
 
-        To add elements to the returned containers, you can use "with" notation
+        To add elements to the returned containers, you can use the "with" notation
         (preferred) or just call methods directly on the returned object. See
         examples below.
 
@@ -183,7 +182,7 @@ class LayoutsMixin:
 
         Examples
         --------
-        You can use `with` notation to insert any element into a column:
+        You can use the `with` notation to insert any element into a column:
 
         >>> import streamlit as st
         >>>
@@ -205,7 +204,7 @@ class LayoutsMixin:
             https://doc-columns1.streamlit.app/
             height: 620px
 
-        Or you can just call methods directly in the returned objects:
+        Or you can just call methods directly on the returned objects:
 
         >>> import streamlit as st
         >>> import numpy as np
@@ -277,7 +276,7 @@ class LayoutsMixin:
         Tabs are a navigational element that allows users to easily
         move between groups of related content.
 
-        To add elements to the returned containers, you can use "with" notation
+        To add elements to the returned containers, you can use the "with" notation
         (preferred) or just call methods directly on the returned object. See
         examples below.
 
@@ -318,7 +317,7 @@ class LayoutsMixin:
 
         Examples
         --------
-        You can use `with` notation to insert any element into a tab:
+        You can use test `with` notation to insert any element into a tab:
 
         >>> import streamlit as st
         >>>
@@ -340,7 +339,7 @@ class LayoutsMixin:
             https://doc-tabs1.streamlit.app/
             height: 620px
 
-        Or you can just call methods directly in the returned objects:
+        Or you can just call methods directly on the returned objects:
 
         >>> import streamlit as st
         >>> import numpy as np
@@ -389,7 +388,7 @@ class LayoutsMixin:
         and can be expanded or collapsed by the user. When collapsed, all that is
         visible is the provided label.
 
-        To add elements to the returned container, you can use "with" notation
+        To add elements to the returned container, you can use the "with" notation
         (preferred) or just call methods directly on the returned object. See
         examples below.
 
@@ -426,7 +425,7 @@ class LayoutsMixin:
 
         Examples
         --------
-        You can use `with` notation to insert any element into an expander
+        You can use the `with` notation to insert any element into an expander
 
         >>> import streamlit as st
         >>>
@@ -444,7 +443,7 @@ class LayoutsMixin:
             https://doc-expander.streamlit.app/
             height: 750px
 
-        Or you can just call methods directly in the returned objects:
+        Or you can just call methods directly on the returned objects:
 
         >>> import streamlit as st
         >>>
@@ -476,6 +475,112 @@ class LayoutsMixin:
 
         return self.dg._block(block_proto=block_proto)
 
+    @gather_metrics("popover")
+    def popover(
+        self,
+        label: str,
+        *,
+        help: str | None = None,
+        disabled: bool = False,
+        use_container_width: bool = False,
+    ) -> "DeltaGenerator":
+        r"""Insert a popover container.
+
+        Inserts a multi-element container as a popover. It consists of a button-like
+        element and a container that opens when the button is clicked.
+
+        To add elements to the returned container, you can use the "with"
+        notation (preferred) or just call methods directly on the returned object.
+        See examples below.
+
+        .. warning::
+            You may not put a popover inside another popover.
+
+        Parameters
+        ----------
+        label : str
+            The label of the button that opens the popover container.
+            The label can optionally contain Markdown and supports the
+            following elements: Bold, Italics, Strikethroughs, Inline Code,
+            Emojis, and Links.
+
+            This also supports:
+
+            * Emoji shortcodes, such as ``:+1:``  and ``:sunglasses:``.
+                For a list of all supported codes,
+                see https://share.streamlit.io/streamlit/emoji-shortcodes.
+
+            * LaTeX expressions, by wrapping them in "$" or "$$" (the "$$"
+                must be on their own lines). Supported LaTeX functions are listed
+                at https://katex.org/docs/supported.html.
+
+            * Colored text, using the syntax ``:color[text to be colored]``,
+                where ``color`` needs to be replaced with any of the following
+                supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+
+            Unsupported elements are unwrapped so only their children (text contents) render.
+            Display unsupported elements as literal characters by
+            backslash-escaping them. E.g. ``1\. Not an ordered list``.
+
+        help : str
+            An optional tooltip that gets displayed when the popover button is
+            hovered over.
+
+        disabled : bool
+            An optional boolean, which disables the popover button if set to
+            True. The default is False.
+
+        use_container_width : bool
+            An optional boolean, which makes the popover button stretch its width
+            to match the parent container. This only affects the button and not
+            the width of the popover container.
+
+        Examples
+        --------
+        You can use the `with` notation to insert any element into a popover
+
+        >>> import streamlit as st
+        >>>
+        >>> with st.popover("Open popover"):
+        >>>     st.markdown("Hello World 👋")
+        >>>     name = st.text_input("What's your name?")
+        >>>
+        >>> st.write("Your name:", name)
+
+        .. output ::
+            https://doc-popover.streamlit.app/
+            height: 400px
+
+        Or you can just call methods directly on the returned objects:
+
+        >>> import streamlit as st
+        >>>
+        >>> popover = st.popover("Open popover")
+        >>> popover.markdown("Hello World 👋")
+        >>> name = popover.text_input("What's your name?")
+        >>>
+        >>> st.write("Your name:", name)
+
+        .. output ::
+            https://doc-popover.streamlit.app/
+            height: 400px
+        """
+        if label is None:
+            raise StreamlitAPIException("A label is required for a popover")
+
+        popover_proto = BlockProto.Popover()
+        popover_proto.label = label
+        popover_proto.use_container_width = use_container_width
+        popover_proto.disabled = disabled
+        if help:
+            popover_proto.help = str(help)
+
+        block_proto = BlockProto()
+        block_proto.allow_empty = True
+        block_proto.popover.CopyFrom(popover_proto)
+
+        return self.dg._block(block_proto=block_proto)
+
     @gather_metrics("status")
     def status(
         self,
@@ -550,7 +655,7 @@ class LayoutsMixin:
         Examples
         --------
 
-        You can use `with` notation to insert any element into an status container:
+        You can use the `with` notation to insert any element into an status container:
 
         >>> import time
         >>> import streamlit as st

streamlit-nightly-1.31.2.dev20240221/streamlit/proto/Block_pb2.py

@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: streamlit/proto/Block.proto
+"""Generated protocol buffer code."""
+from google.protobuf.internal import builder as _builder
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1bstreamlit/proto/Block.proto\"\xfd\x06\n\x05\x42lock\x12#\n\x08vertical\x18\x01 \x01(\x0b\x32\x0f.Block.VerticalH\x00\x12\'\n\nhorizontal\x18\x02 \x01(\x0b\x32\x11.Block.HorizontalH\x00\x12\x1f\n\x06\x63olumn\x18\x03 \x01(\x0b\x32\r.Block.ColumnH\x00\x12\'\n\nexpandable\x18\x04 \x01(\x0b\x32\x11.Block.ExpandableH\x00\x12\x1b\n\x04\x66orm\x18\x05 \x01(\x0b\x32\x0b.Block.FormH\x00\x12,\n\rtab_container\x18\x06 \x01(\x0b\x32\x13.Block.TabContainerH\x00\x12\x19\n\x03tab\x18\x07 \x01(\x0b\x32\n.Block.TabH\x00\x12*\n\x0c\x63hat_message\x18\t \x01(\x0b\x32\x12.Block.ChatMessageH\x00\x12!\n\x07popover\x18\n \x01(\x0b\x32\x0e.Block.PopoverH\x00\x12\x13\n\x0b\x61llow_empty\x18\x08 \x01(\x08\x1a*\n\x08Vertical\x12\x0e\n\x06\x62order\x18\x01 \x01(\x08\x12\x0e\n\x06height\x18\x02 \x01(\r\x1a\x19\n\nHorizontal\x12\x0b\n\x03gap\x18\x01 \x01(\t\x1a%\n\x06\x43olumn\x12\x0e\n\x06weight\x18\x01 \x01(\x01\x12\x0b\n\x03gap\x18\x02 \x01(\t\x1aM\n\nExpandable\x12\r\n\x05label\x18\x01 \x01(\t\x12\x15\n\x08\x65xpanded\x18\x02 \x01(\x08H\x00\x88\x01\x01\x12\x0c\n\x04icon\x18\x03 \x01(\tB\x0b\n\t_expanded\x1a@\n\x04\x46orm\x12\x0f\n\x07\x66orm_id\x18\x01 \x01(\t\x12\x17\n\x0f\x63lear_on_submit\x18\x02 \x01(\x08\x12\x0e\n\x06\x62order\x18\x03 \x01(\x08\x1a\x0e\n\x0cTabContainer\x1a\x14\n\x03Tab\x12\r\n\x05label\x18\x01 \x01(\t\x1aU\n\x07Popover\x12\r\n\x05label\x18\x01 \x01(\t\x12\x1b\n\x13use_container_width\x18\x02 \x01(\x08\x12\x0c\n\x04help\x18\x03 \x01(\t\x12\x10\n\x08\x64isabled\x18\x04 \x01(\x08\x1a\x8d\x01\n\x0b\x43hatMessage\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06\x61vatar\x18\x02 \x01(\t\x12\x32\n\x0b\x61vatar_type\x18\x03 \x01(\x0e\x32\x1d.Block.ChatMessage.AvatarType\",\n\nAvatarType\x12\t\n\x05IMAGE\x10\x00\x12\t\n\x05\x45MOJI\x10\x01\x12\x08\n\x04ICON\x10\x02\x42\x06\n\x04typeB*\n\x1c\x63om.snowflake.apps.streamlitB\nBlockProtob\x06proto3')
+
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, globals())
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'streamlit.proto.Block_pb2', globals())
+if _descriptor._USE_C_DESCRIPTORS == False:
+
+  DESCRIPTOR._options = None
+  DESCRIPTOR._serialized_options = b'\n\034com.snowflake.apps.streamlitB\nBlockProto'
+  _BLOCK._serialized_start=32
+  _BLOCK._serialized_end=925
+  _BLOCK_VERTICAL._serialized_start=395
+  _BLOCK_VERTICAL._serialized_end=437
+  _BLOCK_HORIZONTAL._serialized_start=439
+  _BLOCK_HORIZONTAL._serialized_end=464
+  _BLOCK_COLUMN._serialized_start=466
+  _BLOCK_COLUMN._serialized_end=503
+  _BLOCK_EXPANDABLE._serialized_start=505
+  _BLOCK_EXPANDABLE._serialized_end=582
+  _BLOCK_FORM._serialized_start=584
+  _BLOCK_FORM._serialized_end=648
+  _BLOCK_TABCONTAINER._serialized_start=650
+  _BLOCK_TABCONTAINER._serialized_end=664
+  _BLOCK_TAB._serialized_start=666
+  _BLOCK_TAB._serialized_end=686
+  _BLOCK_POPOVER._serialized_start=688
+  _BLOCK_POPOVER._serialized_end=773
+  _BLOCK_CHATMESSAGE._serialized_start=776
+  _BLOCK_CHATMESSAGE._serialized_end=917
+  _BLOCK_CHATMESSAGE_AVATARTYPE._serialized_start=873
+  _BLOCK_CHATMESSAGE_AVATARTYPE._serialized_end=917
+# @@protoc_insertion_point(module_scope)

{streamlit-nightly-1.31.2.dev20240219 → streamlit-nightly-1.31.2.dev20240221}/streamlit/proto/Block_pb2.pyi

@@ -133,6 +133,27 @@ class Block(google.protobuf.message.Message):
         ) -> None: ...
         def ClearField(self, field_name: typing_extensions.Literal["label", b"label"]) -> None: ...
 
+    class Popover(google.protobuf.message.Message):
+        DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+        LABEL_FIELD_NUMBER: builtins.int
+        USE_CONTAINER_WIDTH_FIELD_NUMBER: builtins.int
+        HELP_FIELD_NUMBER: builtins.int
+        DISABLED_FIELD_NUMBER: builtins.int
+        label: builtins.str
+        use_container_width: builtins.bool
+        help: builtins.str
+        disabled: builtins.bool
+        def __init__(
+            self,
+            *,
+            label: builtins.str = ...,
+            use_container_width: builtins.bool = ...,
+            help: builtins.str = ...,
+            disabled: builtins.bool = ...,
+        ) -> None: ...
+        def ClearField(self, field_name: typing_extensions.Literal["disabled", b"disabled", "help", b"help", "label", b"label", "use_container_width", b"use_container_width"]) -> None: ...
+
     class ChatMessage(google.protobuf.message.Message):
         DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
@@ -174,6 +195,7 @@ class Block(google.protobuf.message.Message):
     TAB_CONTAINER_FIELD_NUMBER: builtins.int
     TAB_FIELD_NUMBER: builtins.int
     CHAT_MESSAGE_FIELD_NUMBER: builtins.int
+    POPOVER_FIELD_NUMBER: builtins.int
     ALLOW_EMPTY_FIELD_NUMBER: builtins.int
     @property
     def vertical(self) -> global___Block.Vertical: ...
@@ -191,6 +213,8 @@ class Block(google.protobuf.message.Message):
     def tab(self) -> global___Block.Tab: ...
     @property
     def chat_message(self) -> global___Block.ChatMessage: ...
+    @property
+    def popover(self) -> global___Block.Popover: ...
     allow_empty: builtins.bool
     def __init__(
         self,
@@ -203,10 +227,11 @@ class Block(google.protobuf.message.Message):
         tab_container: global___Block.TabContainer | None = ...,
         tab: global___Block.Tab | None = ...,
         chat_message: global___Block.ChatMessage | None = ...,
+        popover: global___Block.Popover | None = ...,
         allow_empty: builtins.bool = ...,
     ) -> None: ...
-    def HasField(self, field_name: typing_extensions.Literal["chat_message", b"chat_message", "column", b"column", "expandable", b"expandable", "form", b"form", "horizontal", b"horizontal", "tab", b"tab", "tab_container", b"tab_container", "type", b"type", "vertical", b"vertical"]) -> builtins.bool: ...
-    def ClearField(self, field_name: typing_extensions.Literal["allow_empty", b"allow_empty", "chat_message", b"chat_message", "column", b"column", "expandable", b"expandable", "form", b"form", "horizontal", b"horizontal", "tab", b"tab", "tab_container", b"tab_container", "type", b"type", "vertical", b"vertical"]) -> None: ...
-    def WhichOneof(self, oneof_group: typing_extensions.Literal["type", b"type"]) -> typing_extensions.Literal["vertical", "horizontal", "column", "expandable", "form", "tab_container", "tab", "chat_message"] | None: ...
+    def HasField(self, field_name: typing_extensions.Literal["chat_message", b"chat_message", "column", b"column", "expandable", b"expandable", "form", b"form", "horizontal", b"horizontal", "popover", b"popover", "tab", b"tab", "tab_container", b"tab_container", "type", b"type", "vertical", b"vertical"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing_extensions.Literal["allow_empty", b"allow_empty", "chat_message", b"chat_message", "column", b"column", "expandable", b"expandable", "form", b"form", "horizontal", b"horizontal", "popover", b"popover", "tab", b"tab", "tab_container", b"tab_container", "type", b"type", "vertical", b"vertical"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing_extensions.Literal["type", b"type"]) -> typing_extensions.Literal["vertical", "horizontal", "column", "expandable", "form", "tab_container", "tab", "chat_message", "popover"] | None: ...
 
 global___Block = Block

{streamlit-nightly-1.31.2.dev20240219 → streamlit-nightly-1.31.2.dev20240221}/streamlit/runtime/scriptrunner/script_runner.py

@@ -512,7 +512,7 @@ class ScriptRunner:
                 #         ...
                 #     ```
                 # in their scripts.
-                module = _new_module("__main__")
+                module = self._new_module("__main__")
 
                 # Install the fake module as the __main__ module. This allows
                 # the pickle module to work inside the user's code, since it now
@@ -626,6 +626,10 @@ class ScriptRunner:
         if config.get_option("runner.postScriptGC"):
             gc.collect(2)
 
+    def _new_module(self, name: str) -> types.ModuleType:
+        """Create a new module with the given name."""
+        return types.ModuleType(name)
+
 
 class ScriptControlException(BaseException):
     """Base exception for ScriptRunner."""
@@ -676,11 +680,6 @@ def _clean_problem_modules() -> None:
             pass
 
 
-def _new_module(name: str) -> types.ModuleType:
-    """Create a new module with the given name."""
-    return types.ModuleType(name)
-
-
 # The reason this is not a decorator is because we want to make it clear at the
 # calling location that this function is being used.
 def _log_if_error(fn: Callable[[], None]) -> None:

{streamlit-nightly-1.31.2.dev20240219 → streamlit-nightly-1.31.2.dev20240221}/streamlit/static/asset-manifest.json

@@ -1,7 +1,7 @@
 {
   "files": {
     "main.css": "./static/css/main.77d1c464.css",
-    "main.js": "./static/js/main.18f7df63.js",
+    "main.js": "./static/js/main.c1c90505.js",
     "static/js/9336.2d95d840.chunk.js": "./static/js/9336.2d95d840.chunk.js",
     "static/js/9330.c0dd1723.chunk.js": "./static/js/9330.c0dd1723.chunk.js",
     "static/js/7217.d970c074.chunk.js": "./static/js/7217.d970c074.chunk.js",
@@ -150,6 +150,6 @@
   },
   "entrypoints": [
     "static/css/main.77d1c464.css",
-    "static/js/main.18f7df63.js"
+    "static/js/main.c1c90505.js"
   ]
 }

{streamlit-nightly-1.31.2.dev20240219 → streamlit-nightly-1.31.2.dev20240221}/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.18f7df63.js"></script><link href="./static/css/main.77d1c464.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.c1c90505.js"></script><link href="./static/css/main.77d1c464.css" rel="stylesheet"></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>